API · List files

List files

GET/clients/{client_id}/workspaces/{workspace_id}/files

See every file in a workspace, its current version, and the tables it produced.

curl "https://api.factql.ai/clients/$CLIENT_ID/workspaces/$WORKSPACE_ID/files" \
  -H "X-API-Key: $FACTQL_API_KEY"

Path

client_idstring · required

Your tenant, from GET /whoami.

workspace_idstring · required

The workspace, from GET /whoami.

Response

200

{
  "files": [
    {
      "id": 42,
      "filename": "orders_2026.csv",
      "sha256": "ffe98cef…",
      "byte_size": 48213,
      "version": 2,
      "tables": [{ "table_name": "orders_2026", "row_count": 600, "column_count": 8 }],
      "status": "ready",
      "error": null,
      "created_at": "2026-09-16T17:30:21"
    }
  ],
  "count": 1
}

File fields

idinteger

Use it to delete the file.

versioninteger

Goes up each time a file with the same name and different contents is uploaded.

tablesarray

The tables built from the file's sheets.

statusstring

The file's ingest state; error explains a failure.

Errors

401The key is missing, invalid or revoked.

403The key belongs to a different tenant, or it's the read-only sample key.

404The workspace doesn't exist.