Change Subscription Plan

patch/v1/graphs/{graph_id}/subscriptions

For repositories: synchronous tier change. For user graphs: use POST /v1/graphs/{graph_id}/operations/change-tier instead — this endpoint rejects graph tier changes. 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
`graph_id`required	string	Graph ID or repository name

Request body

Required, application/json.

Field	Type	Description
`new_plan_name`required	string	New plan name to change to
`user_id`optional	string	Organization member whose subscription to change. Defaults to the caller; targeting another member requires org owner or admin.

Example request

curl

curl -X PATCH "https://api.robosystems.ai/v1/graphs/{graph_id}/subscriptions" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "new_plan_name": "advanced"
}'

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