Skip to main content
POST
Create task

Authorizations

Authorization
string
header
required

Session token issued by the desktop/native auth exchange, sent as Authorization: Bearer .

Body

application/json
workspaceId
string
required
prompt
string
required

Task instruction in natural language

Required string length: 1 - 10000
projectId
string | null
selectedProvider
string

AI provider to use

selectedModel
string

AI model to use

providerKeyId
string
connectorIds
string[]

Connector IDs the agent can use

autonomyLevel
enum<string>
Available options:
supervised,
semi-autonomous,
autonomous

Response

201 - application/json

Task created and run started

data
object