v33

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-2972102177.5 KB
Tasks

Run a Task

Triggers execution of a task by ID using the V2 tasks API.

post/v2/tasks/{taskId}/run

Path parameters

taskIdstring required

The ID of the task to run

Request body

input_paramsobject required

Key-value pairs of input parameters for the task

identity_idstring

Optional identity ID to use for the task

session_idstring

Optional session ID to run the task in

cleanup_sessionsboolean

Whether to clean up sessions after execution (default: true)

Response

Task run started successfully

run_idstring required

The ID of the task run

status'queued' | 'running' | 'success' | 'failure' | 'timeout' | 'cancelled' required

Current task run status

resultobject

Task output when available

errorstring

Error message when the run fails

session_idstring

Session ID used for this task run