POST
Create Task

Authorizations

Authorization
string
header
required

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

Body

application/json
config
TaskConfig · object
required

LiveKit's AgentTask: an agent with a typed result, on someone else's stack.

It declares no channel, no media and no greeting. Entered by an agent it speaks with that call's voice and hears with its ears; run on its own from POST /task-runs it is an LLM with tools and nobody to talk to. Which of the two happens is the caller's, never the task's.

Response

Successful Response

config
TaskConfig · object
required

LiveKit's AgentTask: an agent with a typed result, on someone else's stack.

It declares no channel, no media and no greeting. Entered by an agent it speaks with that call's voice and hears with its ears; run on its own from POST /task-runs it is an LLM with tools and nobody to talk to. Which of the two happens is the caller's, never the task's.

created_at
string<date-time>
required
created_by
string<uuid> | null
required
id
string<uuid>
required
last_run
TaskRunSummary · object | null
required

A run without its trace, config or inputs: the list item, the task_run.completed webhook body and a task's last_run, one shape for all three.

error is the same object a full run carries rather than a bare type, so one reader answers "how did it go" for both.

published_at
string<date-time> | null
required
published_version
integer | null
required
updated_at
string<date-time>
required
versions
TaskVersionResponse · object[] | null
required