Browse the API reference

List Staging Tables

get/v1/graphs/{graph_id}/tables

Part of Tables.

Returns file count, storage size, row count, and S3 location per table. Tables with file_count=0 are skipped during ingestion.

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}/tables" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

Responses

200 Successful Response

FieldTypeDescription
tablesrequiredTableInfo[]

List of tables

TableInfo fields
FieldTypeDescription
table_namerequiredstring

Table name

row_countrequiredinteger

Approximate row count

file_countoptionalinteger

Number of files

Default: 0

total_size_bytesoptionalinteger

Total size in bytes

Default: 0

s3_locationoptionalstring

S3 location for external tables

total_countrequiredinteger

Total number of tables

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