Cancel Repository Subscription

post/v1/graphs/{graph_id}/subscriptions/cancel

Cancel a shared repository subscription. Two modes via the immediate flag: omit it (default false) to cancel at period end (access stays until the period closes); pass true with confirm=<repo_id> to stop access right away. Members cancel their own subscription; org owners and admins can cancel any member's by passing user_id. For user graphs, use POST /v1/graphs/{graph_id}/operations/delete-graph — this endpoint rejects user graphs.

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
`graph_id`required	string	Repository name (e.g., 'sec', 'industry')

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/graphs/{graph_id}/subscriptions/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