GET
/
invocations
JavaScript
import Kernel from '@onkernel/sdk';

const client = new Kernel({
  apiKey: 'My API Key',
});

// Automatically fetches more pages as needed.
for await (const invocationListResponse of client.invocations.list()) {
  console.log(invocationListResponse.id);
}
[
  {
    "id": "rr33xuugxj9h0bkf1rdt2bet",
    "app_name": "my-app",
    "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"
  }
]

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

app_name
string

Filter results by application name.

action_name
string

Filter results by action name.

deployment_id
string

Filter results by deployment ID.

status
enum<string>

Filter results by invocation status.

Available options:
queued,
running,
succeeded,
failed
since
string

Show invocations that have started since the given time (RFC timestamps or durations like 5m).

Example:

"2025-06-20T12:00:00Z"

limit
integer
default:20

Limit the number of invocations to return.

Required range: 1 <= x <= 100
offset
integer
default:0

Offset the number of invocations to return.

Required range: x >= 0

Response

A list of invocations.

id
string
required

ID of the invocation

Example:

"rr33xuugxj9h0bkf1rdt2bet"

app_name
string
required

Name of the application

Example:

"my-app"

action_name
string
required

Name of the action invoked

Example:

"analyze"

started_at
string<date-time>
required

RFC 3339 Nanoseconds timestamp when the invocation started

Example:

"2024-05-19T15:30:00.000000000Z07:00"

status
enum<string>
required

Status of the invocation

Available options:
queued,
running,
succeeded,
failed
Example:

"succeeded"

payload
string

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

Example:

"{\"data\":\"example input\"}"

output
string

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

Example:

"{\"result\":\"success\",\"data\":\"processed input\"}"

finished_at
string<date-time> | null

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

Example:

"2024-05-19T15:30:05.000000000Z07:00"

status_reason
string

Status reason

Example:

"Invocation completed successfully"