GET /v1/runs/{runId}
The full persisted run (status, messages, usage); 404 covers cross-tenant ids and another client's runs. **Scoped to the calling API-key client:** only a run this client started is reachable — any of its keys, rotations included. Another client's run in the same tenant, a run started before clients were recorded, and another tenant's run are all the same 404 as an unknown id.
Request Path & query Name In Type Required runId path uuid required
Example shell Copy
curl https://api.askamy.co.za/v1/runs/{runId} \
-H "X-Api-Key: $AMY_API_KEY"Responses Schemas AmyUsage Field Type Required inputTokens integer required outputTokens integer required totalTokens integer required reportedCost number | null optional reportedCostCurrency string | null optional cachedInputTokens integer | null optional cacheWriteTokens integer | null optional reasoningTokens integer | null optional uncachedInputTokens integer optional
PendingApprovalDto Field Type Required approvalId uuid required toolName string required argsJson string | null required requestedAt date-time required expiresAt date-time | null required approvableScopes string[] required requestingAgentSlug string | null optional delegatedGatedTools string[] | null optional
PendingQuestionDto Field Type Required questionId uuid required askingAgentSlug string required question string required options QuestionOptionDto[] required recommendedIndex integer | null required allowMultiple boolean required allowFreeText boolean required askedAt date-time required answer QuestionAnswerDto | null optional
ProblemDetails Field Type Required type string | null optional title string | null optional status integer | null optional detail string | null optional instance string | null optional
QuestionAnswerDto Field Type Required chosenIndices integer[] required freeText string | null required declined boolean required answeredAt date-time required
QuestionOptionDto Field Type Required label string required reason string required
RunAgentUsageDto Field Type Required agentSlug string required inputTokens integer required outputTokens integer required totalTokens integer required
RunAttachmentDto Field Type Required runId uuid required id uuid required fileId uuid required kind string required filename string required contentType string required sizeBytes integer required sourceUrl string | null optional
RunConversationContextDto Field Type Required conversationId uuid required title string | null required position integer required runCount integer required previousRunId uuid | null required nextRunId uuid | null required
RunIterationDto Field Type Required id uuid required sequence integer required modelId string required finishReason string | null required inputTokens integer required outputTokens integer required durationMs integer required agentSlug string | null optional parentToolCallId string | null optional
RunMessageDto Field Type Required sequence integer required iterationId uuid | null required role string required kind string required text string | null required toolName string | null required toolCallId string | null required argumentsJson string | null required resultJson string | null required isError boolean required createdAt date-time required agentSlug string | null optional parentToolCallId string | null optional
RunTaskDto Field Type Required id uuid required label string required agentSlug string required status string required runId uuid | null required deadline date-time required resultDigest string | null required errorCode string | null required failureReason string | null required createdAt date-time required startedAt date-time | null required completedAt date-time | null required
RunTaskWaitDto Field Type Required mode string required startedAt date-time required deadline date-time required
RunWorkspaceDto Field Type Required id uuid required slug string required name string required