Cancel Organization Subscription

post/v1/billing/subscriptions/{org_id}/subscription/{subscription_id}/cancel

Cancels a subscription. Default behavior cancels at period end (subscription stays active through the current cycle). Pass immediate=true with confirm=<resource_id> to terminate now and trigger fast-path deprovisioning of the underlying resource. Requires org owner role.

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Path parameters

Name	Type	Description
`org_id`required	string	Org Id
`subscription_id`required	string	Subscription Id

Request body

Optional, application/json.

Field Type Description

Field	Type	Description
`immediate`optional	boolean	If true, cancel immediately and trigger fast-path deprovisioning of the underlying resource (within ~10 minutes). If false (default), cancel at the end of the current billing period. Default: `false`
`confirm`optional	string	Required when immediate=True. Must equal the subscription's resource_id (e.g. graph_id) to confirm intent.
`user_id`optional	string	Organization member whose subscription to cancel. Defaults to the caller; canceling another member's requires org owner or admin.

immediateoptional

boolean

If true, cancel immediately and trigger fast-path deprovisioning of the underlying resource (within ~10 minutes). If false (default), cancel at the end of the current billing period.

Default: false

confirmoptional

string

Required when immediate=True. Must equal the subscription's resource_id (e.g. graph_id) to confirm intent.

user_idoptional

string

Organization member whose subscription to cancel. Defaults to the caller; canceling another member's requires org owner or admin.

Example request

curl

curl -X POST "https://api.robosystems.ai/v1/billing/subscriptions/{org_id}/subscription/{subscription_id}/cancel" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "immediate": false,
  "confirm": "string",
  "user_id": "string"
}'

Responses

200 Successful Response

Field	Type	Description
`id`required	string	Subscription ID
`resource_type`required	string	Resource type (graph or repository)
`resource_id`required	string	Resource identifier
`user_id`optional	string	Organization member the subscription belongs to. Set for repository subscriptions, which are billed to the org but granted per user.
`plan_name`required	string	Current plan name
`plan_display_name`required	string	Human-readable plan name for UI display
`billing_interval`required	string	Billing interval
`status`required	string	Subscription status
`base_price_cents`required	integer	Base price in cents
`current_period_start`optional	string	Current billing period start
`current_period_end`optional	string	Current billing period end
`started_at`optional	string	Subscription start date
`canceled_at`optional	string	Cancellation date
`ends_at`optional	string	Subscription end date (when access will be revoked, especially relevant for cancelled subscriptions)
`created_at`required	string	Creation timestamp
`operation_id`optional	string	Operation ID for tracking async tier changes via SSE

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
422	Validation Error
429	Rate limit exceeded
500	Internal server error