Delete a draft subscription

DELETE

subscriptions

{id}

curl --request DELETE \
  --url https://api.alguna.io/subscriptions/{id} \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'

{
  "detail": "<string>",
  "status": 123
}

Authorizations

Authorization

string

header

required

API key authentication. Pass your API key as a Bearer token.

Headers

Alguna-Version

enum<string>

required

Available options:

2026-04-01

Idempotency-Key

string

A unique string used to ensure the request is processed exactly once. If you retry a request with the same idempotency key within 24 hours, the original response is returned without re-executing the operation.

Maximum string length: 255

Example:

"ik_a1b2c3d4e5f6"

Path Parameters

string

required

Unique identifier for the subscription

Response

No Content

Update a subscriptionPatches metadata on a subscription: name, description, trial period, billing flags, subscription-level discount, spending thresholds, price escalation, and tags. This endpoint does not modify the priced item set. To change items, see the [Updating a Subscription](/docs/api-reference/v2/examples/updating-a-subscription) examples.

⌘I

Delete a draft subscription

curl --request DELETE \
  --url https://api.alguna.io/subscriptions/{id} \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'

{
  "detail": "<string>",
  "status": 123
}