Skip to main content
DELETE
/
subscription
{
  "userId": "user_123456",
  "deviceId": "device_abc123def456",
  "appId": "app_xyz789",
  "subscriptionIds": ["sub_111111", "sub_222222"]
}

{
  "success": true
}
Cancels one or more active subscriptions for the user and device.

​
Authentication

This endpoint requires Signature Authentication.
When cancelling subscriptions, the signature must be generated using the sorted, comma-separated list of subscription IDs as the additionalData parameter.

​
Endpoint

MethodPathDescription
DELETE/subscriptionCancels one or more active subscriptions for the user and device

​
Request Headers

​
X-utilsio-Timestamp
string
required
Current Unix timestamp (seconds)
​
X-utilsio-Signature
string
required
HMAC-SHA256 signature (see authentication note above)

​
Request Body

​
userId
string
required
The unique identifier of the user whose subscriptions are being cancelled.
​
deviceId
string
required
The unique identifier of the device.
​
appId
string
required
The unique identifier for your application.
​
subscriptionIds
array
required
An array of subscription ID strings to cancel.
{
  "userId": "user_123456",
  "deviceId": "device_abc123def456",
  "appId": "app_xyz789",
  "subscriptionIds": ["sub_111111", "sub_222222"]
}

​
Response

​
success
boolean
Indicates if the cancellation was successful.
​
error
string
Error message if the request failed.
{
  "success": true
}

​
HTTP Status Codes

StatusMeaningWhen
200SuccessSubscription cancelled successfully
400Bad RequestInvalid subscription IDs or missing required fields
401UnauthorizedMissing or invalid signature
403ForbiddenInvalid app ID or user does not own the subscriptions
404Not FoundNo valid subscriptions found for the specified IDs
500Server ErrorInternal error occurred

Authorizations

​
X-utilsio-Signature
string
header
required

HMAC-SHA256 signature of the request.

Body

application/json
​
userId
string
required
​
deviceId
string
required
​
appId
string
required
​
subscriptionIds
string[]
required

Response

Subscription cancelled successfully

​
success
boolean
​
error
string
Last modified on January 15, 2026