RevKeen Docs
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 subscription
  • GET /subscriptions — List subscriptions
  • GET /subscriptions/{id} — Get subscription by ID
  • PATCH /subscriptions/{id} — Update subscription details
  • DELETE /subscriptions/{id} — Delete subscription
  • POST /subscriptions/{id}/change-plan — Change subscription plan
  • POST /subscriptions/{id}/change-quantity — Change subscription quantity
  • POST /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.

DELETE
/subscriptions/{subscriptionId}/items/{itemId}
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

Formatuuid
itemId*string

Item UUID

Formatuuid

Response 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