Sign in

v1

latestOpenAPI 3.0.3MIT2026-07-17323590.7 KB
Agent

Get agent run status and events

Returns the current status and all events for an agent run. Only the user who created the run (in the same organization) can access it.

get/api/agent/runs/{runId}

Path parameters

runIdstring required

Agent run ID (base64 URL-safe 32-byte token)

Headers

X-Grafana-Org-Idstring

Grafana organization ID for multi-tenant isolation. Defaults to '1' if not provided.

Response

Agent run details

runIdstring required
status'running' | 'completed' | 'failed' | 'cancelled' required
userIdinteger required
orgIdinteger required
createdAtstring date-time required
updatedAtstring date-time required
errorstring

Error message (only if status is 'failed')