Runs
Get a run
GET
/api/v1alpha1/runs/{run_id}Returns the current state of one analysis run. Poll this endpoint after the 202 acceptance response.
- Access: an alpha-enabled API key with the
VIEW_INSIGHTSpermission. - Watch:
status,summary, the nestederrorobject,case_id, andreport_id. - Not found: a run in another workspace is deliberately indistinguishable from one that does not exist.
When findings are ready, continue to GET /api/v1alpha1/findings?run_id={run_id}.
Authorization
apiKey AuthorizationBearer <token>
In: header
Path Parameters
run_id*string
Identifier of an analysis run, as returned when the run was created.
Query Parameters
expand[]?array<>
Optional related data to include:
- events: timeline event details.
- events.evidence: evidence attached to each timeline event.
- evidence: answer evidence details.
- provenance: curated provenance details.
- snapshots: stored profile, input, and output snapshot references.
- content: rendered report content.
- manifest: report trust bindings and evidence URLs. Expand depth is limited to two path segments. For this endpoint, use snapshots or provenance.
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/run_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "analysis": { "answer_references": [ { "answer_id": "ans_0190b5d4-timeline", "answer_key": "inspection_timeline", "answer_type": "timeline" }, { "answer_id": "ans_0190b5d4-summary", "answer_key": "inspection_summary", "answer_type": "synthesis" } ], "execution_profile_ref": "premium-analysis@1", "limitations": [], "locale": "ja", "reason_code": "present", "request_id": "0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "result_id": "result_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "result_state": "found", "source_ids": [ "vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" ], "sub_state": "completed" }, "created_at": "2026-08-21T09:00:00.000Z", "id": "run_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "kind": "analysis", "status": "completed", "updated_at": "2026-08-21T09:04:30.000Z"}