Subscriptions

Create Repository Subscription

For shared repositories only (sec, industry, etc.). User graph subscriptions are created automatically during provisioning. Subscribes the caller by default; org owners and admins may subscribe another member of their organization by passing user_id. Billing is charged to the organization either way — repository access is per-user, so the subscriber determines who receives access.

post/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

Repository name (e.g., 'sec', 'industry')

Request body

plan_namestring required

Plan name for the repository subscription

user_idstring nullable

Subscribe this user instead of yourself. Org owners and admins only, and the target must belong to the same organization. Omit to subscribe yourself. Repository access is per-user while billing is org-level, so the subscriber is what determines who gets access.

Example request

{
  "plan_name": "sec-starter",
  "user_id": "user_01ABC123"
}

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.