SaaSFlow
DevelopersAPIReferencesubscriptions

Delete subscription

Delete a subscription and its events, which removes its contribution from MRR history for every period it covered. Subscriptions with an `externalId` are mirrored from a billing provider and refuse deletion with 400; cancel them at the source so the next sync reflects it. To end a subscription without erasing its history, record a `cancel` event instead.

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.
DELETE
/companies/{companyId}/subscriptions/{subscriptionId}

Authorization

Authorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

In: header

Path Parameters

companyId*string
Length1 <= length
subscriptionId*string
Length1 <= length

Response Body

application/json

application/json

curl -X DELETE "https://example.com/companies/string/subscriptions/string"
{  "success": true}

Retrieve subscription

Retrieve a single subscription by id. Returns 404 if the subscription does not exist or belongs to another company.

Update subscription

Update a subscription. Only the fields you send change. This edits the container only, never the revenue: to change what a subscription is worth, add or edit its subscription events.