Get File Information
/v1/graphs/{graph_id}/files/{file_id}Part of Files.
Returns per-layer status (layers.s3, layers.duckdb, layers.graph) for pipeline debugging.
Authentication
Authenticate in any one of these ways — not all of them:
- API key in the
X-API-Keyheader. - Bearer token in the
Authorizationheader.
Path parameters
| Name | Type | Description |
|---|---|---|
graph_idrequired | string | Graph Id |
file_idrequired | string | File ID |
Example request
curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/files/{file_id}" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY"Responses
200 Successful Response
| Field | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
file_idrequired | string | Unique file identifier | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
graph_idrequired | string | Graph database identifier | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
table_idrequired | string | Table identifier | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
table_nameoptional | string | Table name | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
file_namerequired | string | Original file name | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
file_formatrequired | string | File format (parquet, csv, etc.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
size_bytesrequired | integer | File size in bytes | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
row_countoptional | integer | Estimated row count | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload_statusrequired | string | Current upload status | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload_methodrequired | string | Upload method used | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
created_atoptional | string | File creation timestamp | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
uploaded_atoptional | string | File upload completion timestamp | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
s3_keyrequired | string | S3 object key | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
layersoptional | EnhancedFileStatusLayers | Multi-layer pipeline status (S3 → DuckDB → Graph). Shows status, timestamps, and row counts for each layer independently. EnhancedFileStatusLayers fields
|
| 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 |