Subscriptions

Delete subscription

Deletes a subscription. Data collection stops immediately and all recorded spans are removed.

New exports for the datastream are rejected with 403 permission_denied ("Subscription has been deleted") until you re-subscribe. Re-subscribing via POST /v1/subscriptions with the same datastream_id reuses the subscription ID and opens a fresh span — it does not restore the deleted subscription’s history.

Export artifacts produced before deletion remain downloadable via GET /v1/exports/{id}/download.

See the Subscription lifecycle guide for the full state machine.

DELETE

subscriptions

{id}

Python (ticksupply library)

# pip install ticksupply
from ticksupply import Client

client = Client(api_key="<api-key>")
client.subscriptions.delete("sub_019478a23c5f7b8e9d12abcdef012345")

{
  "error": {
    "code": "unauthenticated",
    "message": "Invalid or missing API key"
  }
}

Authorizations

X-Api-Key

string

header

required

Your API key. Get one from the dashboard at https://app.ticksupply.com/api-keys

Headers

Idempotency-Key

string<uuid>

Unique key for idempotent requests. If you retry a request with the same key, you'll receive the original response without the operation being performed again.

Must be a valid UUID (any version — v4 recommended for uniqueness), up to 128 characters.

Maximum string length: 128

Path Parameters

string

required

Subscription ID (prefixed format, e.g., sub_xxx)

Pattern: ^sub_[a-f0-9]{32}$

Response

Subscription deleted successfully

Last modified on April 18, 2026

Pause subscriptionPauses data collection for a subscription. The subscription can be resumed later. This operation is idempotent - pausing an already paused subscription succeeds silently.

Python (ticksupply library)

# pip install ticksupply
from ticksupply import Client

client = Client(api_key="<api-key>")
client.subscriptions.delete("sub_019478a23c5f7b8e9d12abcdef012345")

{
  "error": {
    "code": "unauthenticated",
    "message": "Invalid or missing API key"
  }
}