Browse the API reference

List Files in Graph

get/v1/graphs/{graph_id}/files

Part of Files.

Filter by table_name or upload status. Files are graph-scoped resources with S3 → DuckDB → Graph lifecycle tracking.

Authentication

Authenticate in any one of these ways — not all of them:

Name	Type	Description
`graph_id`required	string	Graph Id

Name	Type	Description
`table_name`optional	string	Filter by table name (optional)
`status`optional	string	Filter by upload status (optional)

curl

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

200 Successful Response

Field Type Description

graph_idrequired

string

Graph database identifier

table_nameoptional

string

Table name (null if listing all files in graph)

filesrequired

FileInfo[]

List of files in the table

FileInfo fields

Field	Type	Description
`file_id`required	string	Unique file identifier
`file_name`required	string	Original file name
`file_format`required	string	File format (parquet, csv, etc.)
`size_bytes`required	integer	File size in bytes
`row_count`optional	integer	Estimated row count
`upload_status`required	string	Current upload status
`upload_method`required	string	Upload method used
`created_at`optional	string	File creation timestamp
`uploaded_at`optional	string	File upload completion timestamp
`s3_key`required	string	S3 object key

total_filesrequired

integer

Total number of files

total_size_bytesrequired

integer

Total size of all files in bytes