Api reference
Remove item from subscription
Remove a line item from a subscription. Cannot remove the last item - cancel the subscription instead.
Related endpoints
POST /subscriptions— Create a new subscriptionGET /subscriptions— List subscriptionsGET /subscriptions/{id}— Get subscription by IDPATCH /subscriptions/{id}— Update subscription detailsDELETE /subscriptions/{id}— Delete subscriptionPOST /subscriptions/{id}/change-plan— Change subscription planPOST /subscriptions/{id}/change-quantity— Change subscription quantityPOST /subscriptions/{id}/preview-renewal— Preview subscription renewal
Common errors
400 invalid_request— malformed payload or failed validation.401 unauthenticated— missing, malformed, or revoked API key.404 resource_missing— the referenced resource does not exist or is not visible to your key.
Idempotency
Pass an Idempotency-Key header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see the idempotency guide.
x-api-key<token>
Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.
In: header
Path Parameters
subscriptionId*string
Subscription UUID
Format
uuiditemId*string
Item UUID
Format
uuidResponse Body
application/json
curl -X DELETE "https://api.revkeen.com/v2/subscriptions/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000" \ -H "x-api-key: $REVKEEN_API_KEY"{
"success": true,
"deleted_id": "b2ea24e8-8a1f-4fd3-b024-1aa9f88f8b77"
}Empty
Empty
Empty