Skip to main content

Delete session data

When a source response must be removed, request deletion with the same UUID used for the embed's session or interview reference:

curl --request DELETE \
  "https://api.getramon.com/integrations/v1/surveys/YOUR_SURVEY_ID/sessions/by-reference/11111111-1111-4111-8111-111111111111" \
  --header "Authorization: Bearer YOUR_INTEGRATION_KEY"

Ramon returns 202 Accepted because cleanup is asynchronous. Poll the deletion resource until status becomes completed or failed:

curl "https://api.getramon.com/integrations/v1/surveys/YOUR_SURVEY_ID/session-deletions/11111111-1111-4111-8111-111111111111" \
  --header "Authorization: Bearer YOUR_INTEGRATION_KEY"

The deletion result contains status, attempts, requestedAt, updatedAt, completedAt, and error. Ramon records a tombstone while deletion is pending or after it completes so late or in-flight browser events for the reference do not recreate session data.

Repeat requests for a completed reference return its completed record. A failed or pending request can be retried by issuing the delete request again, then polling the same resource.