---
title: "Update invocation"
method: PATCH
path: "/invocations/{id}"
tags: ["Invocations"]
---

# Update invocation

`PATCH /invocations/{id}`

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

## Path parameters

- `id` string, required

## Request body

- InvocationUpdateRequest — Request body for updating an invocation.
  - `status` 'succeeded' | 'failed', required — New status for the invocation.
  - `output` string — Updated output of the invocation rendered as JSON string.

## Response `200`

Invocation updated successfully

- Invocation
  - `id` string, required — ID of the invocation
  - `app_name` string, required — Name of the application
  - `version` string, required — Version label for the application
  - `action_name` string, required — Name of the action invoked
  - `payload` string — Payload provided to the invocation. This is a string that can be parsed as JSON.
  - `output` string — Output produced by the action, rendered as a JSON string. This could be: string, number, boolean, array, object, or null.
  - `started_at` string, date-time, required — RFC 3339 Nanoseconds timestamp when the invocation started
  - `finished_at` string, 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_reason` string — Status reason

## Other responses

- `400` — Bad Request – invalid input
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/kernel/apis/kernel-api.md) · [All operations](https://skmtc.net/kernel/apis/kernel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/kernel-api/versions/9e8ce9fcf5e1/schema)