Browse the API reference

Get Graph Subscription

get/v1/graphs/{graph_id}/subscriptions

Part of Subscriptions.

Detects resource type automatically: user graphs (kg*) return the graph's subscription; shared repositories return the user's personal subscription to that repo.

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

NameTypeDescription
graph_idrequiredstringGraph ID or repository name

Example request

curl
curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/subscriptions" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

Responses

200 Successful Response

FieldTypeDescription
idrequiredstring

Subscription ID

resource_typerequiredstring

Resource type (graph or repository)

resource_idrequiredstring

Resource identifier

user_idoptionalstring

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

plan_namerequiredstring

Current plan name

plan_display_namerequiredstring

Human-readable plan name for UI display

billing_intervalrequiredstring

Billing interval

statusrequiredstring

Subscription status

base_price_centsrequiredinteger

Base price in cents

current_period_startoptionalstring

Current billing period start

current_period_endoptionalstring

Current billing period end

started_atoptionalstring

Subscription start date

canceled_atoptionalstring

Cancellation date

ends_atoptionalstring

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

created_atrequiredstring

Creation timestamp

operation_idoptionalstring

Operation ID for tracking async tier changes via SSE

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