POST /v1/runs/{runId}/approvals/{approvalId}

Resume an approval-paused run with approve/deny; streams the continuation over SSE.

Streams text/event-stream. The success body is a sequence of events rather than a JSON document, which is why no 2xx schema is listed below — see Streaming for the event contract.

**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. A team run's assignment approval is a 404 here too: a team run is never started by a client, and its approvals are decided in the Console only.

Request

Path & query

NameInTypeRequired
runIdpathuuidrequired
approvalIdpathuuidrequired

Body

application/json — required, ResumeApprovalRequest

Example

shell
curl -X POST https://api.askamy.co.za/v1/runs/{runId}/approvals/{approvalId} \
  -H "X-Api-Key: $AMY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ … }'

Responses

StatusDescriptionBody
400Bad RequestHttpValidationProblemDetails
401UnauthorizedProblemDetails
403ForbiddenProblemDetails
404Not FoundProblemDetails
409ConflictProblemDetails

Schemas

HttpValidationProblemDetails

FieldTypeRequired
typestring | nulloptional
titlestring | nulloptional
statusinteger | nulloptional
detailstring | nulloptional
instancestring | nulloptional
errorsobject optional

McpServerCredential

FieldTypeRequired
serverSlugstring required
tokenstring required

McpServerDeclaration

FieldTypeRequired
slugstring required
urlstring required
authHeaderNamestring | nullrequired
toolsMcpToolBinding[] required

McpToolBinding

FieldTypeRequired
handlestring required
remoteNamestring required

ProblemDetails

FieldTypeRequired
typestring | nulloptional
titlestring | nulloptional
statusinteger | nulloptional
detailstring | nulloptional
instancestring | nulloptional

ResumeApprovalRequest

FieldTypeRequired
decisionstring required
notestring | nulloptional
mcpAuthMcpServerCredential[] | nulloptional
mcpServersMcpServerDeclaration[] | nulloptional