Delete a subscription

DELETE

/api/v1/subscriptions/{subscription_id}

curl --request DELETE \
  --url https://api.inside.chat/api/v1/subscriptions/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'If-Match: example' \
  --data '{}'

• Hosted Gateway
• Local development

Required scopes: website_read, event_read
Data access: –
MCP tool: subscription_delete
Note: Write
Note: optional Idempotency-Key
Note: If-Match required

Delete this installation subscription at its matching revision. Existing cursors become unavailable. With an Idempotency-Key, the same input and effective authority reuse the original result for 24h. Changed input conflicts; changed/deleted targets and expired access withhold saved results. Without a key each request is a new effect. After 24h a key can start a new effect; reconcile before retrying beyond the window.

Authorizations

• installation_token
• oauth_client_credentials
  website_read event_read

Parameters

Path Parameters

subscription_id

required

string

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

Header Parameters

If-Match

required

string

/^"[1-9][0-9]*"$/

Idempotency-Key

string

>= 1 characters <= 128 characters /^[\x21-\x7e]{1,128}$/

Request Body^required

Media typeapplication/json

object

Example ^generated

{}

Responses

200

Current installation-authorized thin metadata. Cursors contain independent per-website positions; no total order is promised.

Media typeapplication/json

object

deleted

required

Example

{
  "deleted": true
}

400

Malformed, duplicate, unsupported input or invalid cursor signature.

401

Expired, revoked or changed credential authority.

404

Subscription or website not granted; restriction filters and human consent credentials are unavailable for this feed.

409

Changed subscription revision, concurrent mutation, inventory limit, or replay_expired requiring reconciliation.

429

Application request quota exceeded.

503

Event family held, corrupt subscription or unavailable journal/control observations.