workflow-runs

Set a WorkflowRun terminal status.

Changed on

Marks a running WorkflowRun as succeeded or failed. The gateway owns request validation and state-transition checks, then patches the WorkflowRun status in the configured namespace.

patch/api/workflow/{agentName}/{workflowName}/run/{runName}/status

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/workflow/{agentName}/{workflowName}/run/{runName}/status
  • Auth: HTTP bearer

Path parameters

agentNamestring required

Agent name.

workflowNamestring required

Workflow name scoped to an agent.

runNamestring required

WorkflowRun resource name.

Request body

phase'Succeeded' | 'Failed' required
messagestring

Response

WorkflowRun status updated.

Changes