List Files | BCTRL Docs

curl -G https://api.bctrl.ai/v2/files \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d spaceId=3fa85f64-5717-4562-b3fc-2c963f66afa6 \
     -d limit=50 \
     -d source=upload \
     --data-urlencode prefix=documents/reports/ \
     --data-urlencode contentType=application/pdf

{
  "data": [
    {
      "contentType": "application/pdf",
      "createdAt": "2024-06-10T09:15:30Z",
      "id": "a3f1c9e2-4d5b-4f7a-9c3e-1b2d3f4a5e6f",
      "name": "report-june-2024.pdf",
      "path": "documents/reports/report-june-2024.pdf",
      "sizeBytes": 1048576,
      "source": "upload",
      "type": "file",
      "downloadUrl": "https://cdn.bctrl.ai/files/3fa85f64-5717-4562-b3fc-2c963f66afa6/report-june-2024.pdf?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
      "expiresAt": "2024-07-10T09:15:30Z",
      "metadata": {
        "author": "Jane Doe",
        "pages": 42,
        "confidential": false
      },
      "runId": null,
      "runtimeId": null,
      "spaceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ],
  "nextCursor": "eyJjdXJzb3IiOiIxMjM0NTY3ODkwIn0="
}

List files in a space using the canonical v2 file resource. Use source and path filters to find uploaded inputs or runtime outputs.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Query parameters

spaceIdstringRequiredformat: "uuid"

cursorstringOptional>=1 character

limitintegerOptional<=500

source"upload" or "runtime" or "system"Optional

pathstringOptional1-4096 characters

prefixstringOptional1-4096 characters

querystringOptional>=1 character

contentTypestringOptional>=1 character

Response

Default Response

datalist of objects

nextCursorstring or null