Browse the API reference

List Subgraphs

get/v1/graphs/{graph_id}/subgraphs

Part of Subgraphs.

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

Example request

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

Responses

200 Successful Response

FieldTypeDescription
parent_graph_idrequiredstring

Parent graph identifier

parent_graph_namerequiredstring

Parent graph name

parent_graph_tierrequiredstring

Parent graph tier

subgraphs_enabledrequiredboolean

Whether subgraphs are enabled for this tier

subgraph_countrequiredinteger

Total number of subgraphs

max_subgraphsoptionalinteger

Maximum allowed subgraphs for this tier (None = unlimited)

total_size_bytesoptionalinteger

Combined on-disk footprint of all subgraphs in bytes

total_size_mboptionalnumber

Combined size of all subgraphs in megabytes

subgraphsrequiredSubgraphSummary[]

List of subgraphs

SubgraphSummary fields
FieldTypeDescription
graph_idrequiredstring

Full subgraph identifier

subgraph_namerequiredstring

Alphanumeric name

display_namerequiredstring

Human-readable name

subgraph_typerequiredSubgraphType

Type of subgraph

One of: static, knowledge, empty

statusrequiredstring

Current status

size_bytesoptionalinteger

On-disk footprint in bytes — the database, its write-ahead log, and its vector index. Prefer this over size_mb at subgraph scale.

size_mboptionalnumber

Same footprint in megabytes. Derived from size_bytes; kept for callers that render MB directly.

created_atrequiredstring (date-time)

Creation timestamp

last_accessedoptionalstring (date-time)

Last access timestamp

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