v97

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-31135175384.2 KB

Invocations

Update invocation

Update an invocation's status or output. This can be used to cancel an invocation by setting the status to "failed".

patch/invocations/{id}

Path parameters

idstring required

Invocation ID

Request body

status'succeeded' | 'failed' required

New status for the invocation.

outputstring

Updated output of the invocation rendered as JSON string.

Response

Invocation updated successfully

idstring required

ID of the invocation

app_namestring required

Name of the application

versionstring required

Version label for the application

action_namestring required

Name of the action invoked

payloadstring

Payload provided to the invocation. This is a string that can be parsed as JSON.

outputstring

Output produced by the action, rendered as a JSON string. This could be: string, number, boolean, array, object, or null.

started_atstring date-time required

RFC 3339 Nanoseconds timestamp when the invocation started

finished_atstring date-time nullable

RFC 3339 Nanoseconds timestamp when the invocation finished (null if still running)

status'queued' | 'running' | 'succeeded' | 'failed' required

Status of the invocation

status_reasonstring

Status reason

Example response

{
  "id": "rr33xuugxj9h0bkf1rdt2bet",
  "app_name": "my-app",
  "version": "1.0.0",
  "action_name": "analyze",
  "payload": "{\"data\":\"example input\"}",
  "output": "{\"result\":\"success\",\"data\":\"processed input\"}",
  "started_at": "2024-05-19T15:30:00.000000000Z07:00",
  "finished_at": "2024-05-19T15:30:05.000000000Z07:00",
  "status": "succeeded",
  "status_reason": "Invocation completed successfully"
}