List Runtime Files | BCTRL Docs

curl https://api.bctrl.ai/v1/runtimes/runtimeId/files \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "data": [
    {
      "contentType": "application/pdf",
      "createdAt": "2024-04-20T14:22:00Z",
      "downloadUrl": "https://storage.bctrl.ai/files/3f5e2a7b-9c4d-4f1a-8b2e-1a2b3c4d5e6f/download",
      "id": "3f5e2a7b-9c4d-4f1a-8b2e-1a2b3c4d5e6f",
      "name": "Q1_Analysis_Report.pdf",
      "path": "/reports/2024/Q1_Analysis_Report.pdf",
      "sizeBytes": 2543210,
      "source": "runtime",
      "spaceId": "f1234567-89ab-4cde-0123-456789abcdef",
      "expiresAt": "2024-05-20T14:22:00Z",
      "metadata": {
        "author": "Jane Doe",
        "description": "Final report for Q1 analysis"
      },
      "runId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "runtimeId": "d4c3b2a1-f6e5-0987-dcba-0987654321fe",
      "type": "report"
    }
  ],
  "nextCursor": "eyJwYWdlIjoyfQ=="
}

List durable files that have been collected out of a runtime workspace and stored by BCTRL. This is the reviewable output surface for files produced by a runtime/run; files that were only staged or pushed into the live runtime but not collected back are not listed here.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

runtimeIdstringRequired

Query parameters

typestring or list of stringsOptional

cursorstringOptional>=1 character

limitintegerOptional<=200Defaults to 50

Response

datalist of objects

nextCursorstring or null

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error