Sign in
Tasks

Run Task

Create and dispatch a new agent task. Returns the task ID and device stream details.

post/tasks

Headers

Idempotency-Keystring nullable

Request body

agentIdinteger
llmModelstring

The LLM model identifier to use for the task (e.g. 'google/gemini-3.5-flash')

taskstring required
maxStepsinteger
temperaturenumber
reasoningboolean
accessibilityboolean
visionboolean
executionTimeoutinteger
appsstring[]
filesstring[]
outputSchemaobject nullable
vpnCountry'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA'
subagentModelstring

LLM model used by sub-agent roles: executor, app_opener, structured_output

stealthboolean
continueOnFailureboolean
memoryNamespacestring

Memory namespace for cross-task personalization

deviceIdstring uuid required

The ID of the device to run the task on.

displayIdinteger

The display ID of the device to run the task on.

Response

Successful Response

idstring uuid required

The ID of the task

status'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled' required
streamUrlstring nullable

The URL of the stream (null when queued)

Changes