---
title: "Invoke an action"
method: POST
path: "/invocations"
tags: ["Invocations"]
---

# Invoke an action

`POST /invocations`

Invoke an action.

## Request body

- object
  - `app_name` string, required — Name of the application
  - `version` string, required — Version of the application
  - `payload` string — Input data for the action, sent as a JSON string.
  - `action_name` string, required — Name of the action to invoke
  - `async` boolean — If true, invoke asynchronously. When set, the API responds 202 Accepted with status "queued".
  - `async_timeout_seconds` integer — Timeout in seconds for async invocations (min 10, max 3600). Only applies when async is true.

## Response `200`

Invocation created successfully

- InvokeResponse
  - `id` string, required — ID of the invocation
  - `action_name` string, required — Name of the action invoked
  - `status` 'queued' | 'running' | 'succeeded' | 'failed', required — Status of the invocation
  - `status_reason` string — Status reason
  - `output` string — The return value of the action that was invoked, rendered as a JSON string. This could be: string, number, boolean, array, object, or null.

## Other responses

- `202` — Invocation queued successfully (asynchronous invocation)
- `400` — Bad Request – invalid input
- `404` — Resource not found
- `429` — Too Many Requests – rate limit exceeded
- `500` — Internal Server Error
- `529` — Capacity exhausted, unable to fulfill request at this time

---

[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/revisions/9e8ce9fcf5e1/schema)