Documentation menu
Agent Runs

Replay a run's lifecycle journal

GET /api/v1/agent-runs/{agentRunId}/transitions

Return the run's full transition journal in seq order. Every lifecycle change (queued→acquiring, …, terminal) is one journal entry carrying the acting component, the attempt it belongs to, and an optional reason.

Authentication

  • Requires a valid session or API key in the Authorization header
  • The credential must be authorized for the canonical Agent Run operation and its Organization/Project/Environment/Agent resource scope

Parameters

path

NameTypeRequiredDescription
agentRunIdstringrequiredIdentifies the agent run whose state or history is addressed. Applies to Replay a run's lifecycle journal.

query

NameTypeRequiredDescription
limitintegeroptionalSets the maximum number of resources returned in this page. Applies to Replay a run's lifecycle journal.
cursorstringoptionalOpaque cursor returned by the previous page; omit it to read the first page. Applies to Replay a run's lifecycle journal.

Responses

StatusDescriptionBody
200Response for status 200application/json — object — data: object (required); pagination: object (required)
400The request is malformed or cannot be processed.application/json — PublicApiError — error: object (required)
401Authentication failed. The Authorization header is missing, or the credential is invalid or expired.application/json — PublicApiError — error: object (required)
403Access denied. The authenticated user does not have permission to perform this action.application/json — PublicApiError — error: object (required)
404Resource not found.application/json — PublicApiError — error: object (required)
409Request conflicts with current state of the resource, including safe deployment conflict classifications.application/json — PublicApiError — error: object (required)
422Request validation failed. Check the request body, query parameters, or path parameters.application/json — PublicApiError — error: object (required)
429Too many requests.application/json — PublicApiError — error: object (required)
500The server could not complete the request.application/json — PublicApiError — error: object (required)
503Service temporarily unavailable (e.g. execution capacity exhausted). The response carries a Retry-After header; retry with backoff.application/json — PublicApiError — error: object (required)