Stamp Delete API

The Stamp Delete API allows you to permanently delete issued stamps.

Once deleted, stamps cannot be restored, and all associated stamp history is removed.
To delete multiple stamps at once, use the dashboard.

This API is available on the Personal plan or higher.

DELETE

/api/stamp/v1/delete?stampIdx={stampIdx} 


DELETE /api/stamp/v1/delete
        ?stampIdx=394

Request Parameters

stampIdx integer required
Stamp IDX. 
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

code integer
Response code: 0 = Success, other values = Error
message string
Response message. If the response code is not 0, an error message is returned.
result null

When Should You Delete a Stamp?

Deleting a stamp is not just data cleanup.
For users, it means losing all accumulated stamps. Review the following before calling the delete API.

When deletion is appropriate

  • Stamps created for testing purposes
  • Duplicate or incorrectly issued stamps that were never exposed to users
  • Stamps already redeemed and no longer needed

When to use the Update API instead

  • Stamps already accumulated by users → Set activeYn to N to deactivate
  • Only need to adjust the validity period → Update endYmd
  • Temporarily restrict usage → Set activeYn to inactive and reactivate when needed

Use with caution in production environments.
Since deletion is irreversible, consider deactivation first for stamps linked to user data.

Operational Considerations

Stamp data is directly tied to user activity history, so deletion must be handled with care.

  • Deletion can affect reward eligibility calculations
  • Outcomes may change in accumulation-based campaigns
  • Consider the risk of user claims or disputes

Where possible, prefer status changes or the Update API over deletion.

How to Find stampIdx

stampIdx is a unique identifier returned in the response when a stamp is created.

If it wasn’t stored at creation time, you can retrieve it from the dashboard.

Since deletion is irreversible, always verify that the stampIdx points to the correct stamp before calling the API.

Use cases

  • Removing incorrect data: Delete stamps that were duplicated due to system or processing errors
  • Cleaning up test data: Remove stamps created during development, staging, or QA processes
  • Cleaning up campaign data: Delete unnecessary stamps from completed or expired campaigns