Tearleads

POST/organizations/{organizationId}/billing/stripe/cancel

Cancel the Stripe subscription

Operation organizations.billing.stripe.cancel

Description

Cancels the organization's Stripe subscription at the end of the paid period and returns when sync ends, or null when it was already cancelling. Only organization administrators may call it; 502 means Stripe could not be reached.

Authentication

Requires a signed-in session: the client sends its session token as a bearer token in the Authorization header.

Parameters

NameInTypeDetails
organizationIdpathstringrequired
  • lowercase UUID v4

Responses

200 OK

application/jsonStripeCancelResponse

The result of cancelling a Stripe subscription at period end.

1 field
  • cancelAtnumberrequirednullable

    Unix time in seconds when sync ends, or null when the subscription was already cancelling.

Other fields are allowed.

Other responses

StatusMeaningBody
400Bad Request

application/jsonErrorResponse

401Unauthorized

application/jsonSessionFailureResponse

403Forbidden

application/jsonErrorResponse

404Not Found

application/jsonErrorResponse

500Internal Server Error

application/jsonErrorResponse

502Bad Gateway

application/jsonErrorResponse

503Service Unavailable

application/jsonErrorResponse