Subscriptions

Change Subscription Plan

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.

patch/v1/graphs/{graph_id}/subscriptions

Request

  • Base URL: https://api.robosystems.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.robosystems.ai/v1/graphs/{graph_id}/subscriptions
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required

Graph ID or repository name

Request body

new_plan_namestring required

New plan name to change to

user_idstring nullable

Organization member whose subscription to change. Defaults to the caller; targeting another member requires org owner or admin.

Example request

{
  "new_plan_name": "advanced"
}

Response

Successful Response

idstring required

Subscription ID

resource_typestring required

Resource type (graph or repository)

resource_idstring required

Resource identifier

user_idstring nullable

Organization member the subscription belongs to. Set for repository subscriptions, which are billed to the org but granted per user.

plan_namestring required

Current plan name

plan_display_namestring required

Human-readable plan name for UI display

billing_intervalstring required

Billing interval

statusstring required

Subscription status

base_price_centsinteger required

Base price in cents

current_period_startstring nullable

Current billing period start

current_period_endstring nullable

Current billing period end

started_atstring nullable

Subscription start date

canceled_atstring nullable

Cancellation date

ends_atstring nullable

Subscription end date (when access will be revoked, especially relevant for cancelled subscriptions)

created_atstring required

Creation timestamp

operation_idstring nullable

Operation ID for tracking async tier changes via SSE

Changes

No recorded changes to this operation across all 1 revision of this API.