List Run Artifacts

GET

/v1/runs/:id/artifacts

GET

/v1/runs/:id/artifacts

1 curl https://api.bctrl.ai/v1/runs/id/artifacts \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json"

1 {
2   "artifacts": [
3     {
4       "contentType": "video/mp4",
5       "createdAt": "2024-06-10T15:45:30Z",
6       "fileId": "123e4567-e89b-12d3-a456-426614174000",
7       "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
8       "kind": "recording",
9       "name": "session-recording-20240610.mp4",
10       "path": "/recordings/session-recording-20240610.mp4",
11       "runId": "run-9876543210abcdef",
12       "runtimeId": "runtime-1234abcd5678efgh",
13       "runtimeKind": "browser",
14       "sizeBytes": 104857600,
15       "downloadUrl": "https://cdn.bctrl.ai/artifacts/123e4567-e89b-12d3-a456-426614174000/download"
16     }
17   ],
18   "nextCursor": "eyJjdXJzb3IiOiIyMDI0MDYxMDE1NDUzMCJ9"
19 }

List artifacts produced by a run. Artifacts are structured outputs such as captures, downloads, recordings, or files created during runtime work.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Query parameters

cursorstringOptional>=1 character

limitintegerOptional<=500

kindstring or list of stringsOptional

Response

Page of artifacts with optional next cursor

artifactslist of objects

nextCursorstring or null

Errors

404

Not Found Error