Get Graph Operational Limits

get/v1/graphs/{graph_id}/limits

Limits vary by subscription tier (ladybug-standard, ladybug-large, ladybug-xlarge). Includes storage, query, backup, rate, credit, document, and instance usage limits.

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

Example request

curl

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

Responses

200 Successful Response

Field Type Description

graph_idrequired

string

Graph database identifier

subscription_tierrequired

string

Rate-limit tier enforced for requests to this graph

graph_tierrequired

string

Graph's database tier

is_shared_repositoryrequired

boolean

Whether this is a shared repository

storagerequired

StorageLimits

Storage limits and usage

StorageLimits fields

Field	Type	Description
`current_usage_gb`optional	number	Current storage usage in GB
`max_storage_gb`required	number	Maximum storage limit in GB
`approaching_limit`required	boolean	Whether approaching storage limit (>80%)

queriesrequired

QueryLimits

Query operation limits

QueryLimits fields

Field	Type	Description
`max_timeout_seconds`required	integer	Maximum query timeout in seconds
`chunk_size`required	integer	Maximum chunk size for result streaming
`max_rows_per_query`required	integer	Maximum rows returned per query
`concurrent_queries`required	integer	Maximum concurrent queries allowed

copy_operationsrequired

CopyOperationLimits

Copy/ingestion operation limits

CopyOperationLimits fields

Field	Type	Description
`max_file_size_gb`required	number	Maximum file size in GB
`timeout_seconds`required	integer	Operation timeout in seconds
`concurrent_operations`required	integer	Maximum concurrent operations
`max_files_per_operation`required	integer	Maximum files per operation
`daily_copy_operations`required	integer	Daily operation limit
`supported_formats`required	string[]	Supported file formats

backupsrequired

BackupLimits

Backup operation limits

BackupLimits fields

Field	Type	Description
`max_backup_size_gb`required	number	Maximum backup size in GB
`backup_retention_days`required	integer	Backup retention period in days
`max_backups_per_day`required	integer	Maximum backups per day

rate_limitsrequired

RateLimits

API rate limits

RateLimits fields

Field	Type	Description
`requests_per_minute`required	integer	Requests per minute limit
`requests_per_hour`required	integer	Requests per hour limit
`burst_capacity`required	integer	Burst capacity for short spikes

creditsoptional

CreditLimits

AI credit limits (if applicable)

CreditLimits fields

Field	Type	Description
`monthly_ai_credits`required	integer	Monthly AI credits allocation
`current_balance`required	integer	Current credit balance

documentsoptional

DocumentLimits

Knowledge-base document usage and tier cap (user graphs only)

DocumentLimits fields

Field	Type	Description
`current_count`required	integer	Uploaded documents currently stored for this graph
`max_documents`optional	integer	Maximum uploaded documents for this tier (null when uncapped)
`approaching_limit`required	boolean	Whether approaching document limit (>80%)

subgraphsoptional

SubgraphLimits

Subgraph count and tier cap (parent user graphs only)

SubgraphLimits fields

Field	Type	Description
`current_count`required	integer	Subgraphs currently provisioned under this graph
`max_allowed`optional	integer	Maximum subgraphs for this tier (null when uncapped)
`remaining`optional	integer	Subgraphs that can still be created (null when uncapped)
`approaching_limit`required	boolean	Whether approaching subgraph limit (>80%)

contentoptional

ContentLimits

Per-operation materialization limits (if applicable)

ContentLimits fields

Field	Type	Description
`max_rows_per_copy`required	integer	Maximum rows per copy/materialization operation
`max_single_table_rows`required	integer	Maximum rows per staging table
`chunk_size_rows`required	integer	Rows per materialization chunk

instanceoptional

InstanceUsage

Aggregate instance storage usage (user graphs only)

InstanceUsage fields

Field Type Description

node_countoptional

integer

Current node count (informational, no limit enforced)

total_storage_gboptional

number

Total storage used across all databases in GB

limit_gbrequired

number

Soft storage limit for this tier in GB

usage_percentageoptional

number

Storage usage as percentage of limit (e.g. 105.2). Derived from the enforced figure — durable bytes only, excluding `transient` build artifacts — so it can read lower than total_storage_gb/limit_gb while a blue-green rebuild is in flight.

statusrequired

string

Instance status: 'healthy' (<80%), 'approaching' (80-100%), 'over_limit' (>100%)

databasesoptional

DatabaseStorageEntry[]

Per-database storage breakdown

DatabaseStorageEntry fields

Field Type Description

graph_idrequired

string

Database identifier

is_parentoptional

boolean

Whether this is the parent graph

Default: false

size_mboptional

number

Database size in MB

itemsoptional

StorageItem[]

Itemized storage by type — graph, memory, subgraph, vectors, staging, transient, orphan. Sums to total_storage_gb. Only `subgraph` items correspond to live subgraphs, so this is the type to sum when reconciling against the subgraph list.

StorageItem fields

Field	Type	Description
`type`required	string	One of: graph, memory, subgraph, vectors, staging, transient (blue-green build artifact), orphan (a `{parent}_*` database, vector index, or staging file with no row in the graph registry — leftover of a deleted subgraph). Transient and orphan items are collected by the platform's daily storage-reclaim job.
`id`required	string	Database or index identifier
`bytes`required	integer	Size in bytes

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