List runs
/api/v1alpha1/runsReturns workspace analysis runs, newest first.
- Access: an alpha-enabled API key with the
VIEW_INSIGHTSpermission. - Filters:
video_id,status. - Paging:
limitdefaults to 25, maximum 100. Passnext_cursorunchanged ascursor.
Use a run identifier from this list with GET /api/v1alpha1/runs/{run_id}, or use it with GET /api/v1alpha1/findings?run_id={run_id}.
Authorization
apiKey In: header
Query Parameters
Opaque cursor returned as next_cursor by the previous response. Pass it byte-for-byte as cursor; do not decode, edit, or construct it.
Number of resources to return in one page. The default is 25 and the accepted range is 1-100.
int321 <= value <= 10025Return only runs whose stored source snapshot contains this video identifier.
Coarse processing status for a run:
- queued: accepted and waiting to start.
- processing: work is in progress.
- completed: processing finished and the result can be read.
- failed: processing ended without a usable result.
- canceled: processing was stopped before completion. Use this field to filter analysis runs by status.
Value in
- "queued"
- "processing"
- "completed"
- "failed"
- "canceled"
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1alpha1/runs" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "data": [ { "created_at": "2026-08-08T10:00:00.000Z", "id": "run_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "kind": "workflow", "status": "processing", "updated_at": "2026-08-08T10:07:30.000Z", "workflow": { "workflow_id": "wf_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" } } ], "has_more": false, "next_cursor": "MDEyMzQ1Njc4OWFitSLKnTQIcJAwDPi07V5EGs76Im3F8rCuUshrBnHuUJY7_8Ie8Stea_TKuhKhDw5XkRdkBI3IKkvsKT9Kp60Wpx7CoTCGQW8FnalDILVbuy8wxvWWf_B8SA"}