Acknowledge a mobile survey handoff

Requires retention:view and retention:edit. Idempotent and scoped to this project, delivery and receiptToken. Report ACCEPTED when your notification provider accepts, DELIVERED only with provider/device evidence, FAILED when definitely not delivered, OPENED only after a real user opens the notification, and CLICKED after a deliberate interaction. Send receipts from your merchant server, never expose the secret API key or receiptToken in an app binary. Opening and clicking imply delivery; repeated or out-of-order receipts preserve the first timestamps and cannot downgrade DELIVERED. Bitelio never automatically reissues an uncertain handoff. Tracking-disabled projects and customers who withdraw from follow-up do not collect interaction timestamps. Limit 120 requests/minute shared per project.

Authorization

ApiKeyAuth

AuthorizationBearer <token>

API Key authentication. Secret keys (sk_*) are required for all endpoints except /v1/track. Public keys (pk_*) only work with the /v1/track endpoint for client-side event tracking. The project is automatically derived from the key.

In: header

Path Parameters

id*string

Lengthlength <= 100

Request Body

application/json

receiptToken*string

Formatuuid

status*string

Value in"ACCEPTED" | "DELIVERED" | "FAILED" | "OPENED" | "CLICKED"

[key: string]?never

Response Body

`application/json`

curl -X POST "https://bitelio-api.heltia.com/v1/retention/survey-deliveries/string/receipt" \
  -H "Content-Type: application/json" \
  -d '{
    "receiptToken": "f7b0d1df-daa1-490a-b9fc-05372d34c946",
    "status": "ACCEPTED"
  }'

curl -X POST "https://bitelio-api.heltia.com/v1/retention/survey-deliveries/string/receipt" \  -H "Content-Type: application/json" \  -d '{    "receiptToken": "f7b0d1df-daa1-490a-b9fc-05372d34c946",    "status": "ACCEPTED"  }'

{
  "acknowledged": true
}

Empty