Skip to main content
POST
/
task
curl -X POST "https://api2.circlemind.co/api/v1/task" \
     -H "Content-Type: application/json" \
     -H "apikey: YOUR_API_KEY" \
     -d '{
       "task": "Go to hacker news and get the top 5 stories.",
       "device": "desktop",
       "max_steps": 32,
       "enable_recording": true
     }'
{
  "id": "<string>",
  "status": "waiting",
  "output": "<any>",
  "credits_used": 123,
  "device": "desktop",
  "live_url": "<string>",
  "recording_url": "<string>"
}

Authorizations

​
apikey
string
header
required

Body

application/json

Run task request model.

​
task
string
required

The task to run.

​
response_model
object

If provided, the JSON schema describing the desired output structure.

​
url
string<uri> | null

The starting URL for the task. If not provided, the agent will start from a blank page.

​
metadata
object

A dictionary containing variables or parameters that will be passed to the agent.

​
agent
enum<string>
default:smooth

The agent to use for the task.

Available options:
smooth
​
max_steps
integer
default:32

Maximum number of steps the agent can take (min 2, max 128).

Required range: 2 <= x <= 128
​
device
enum<string>
default:mobile

Device type for the task. Default is mobile.

Available options:
desktop,
mobile
​
enable_recording
boolean
default:false

Enable video recording of the task execution. Default is False

​
session_id
string | null

Browser session ID to use. Each session maintains its own state, such as login credentials.

​
stealth_mode
boolean
default:false

Run the browser in stealth mode.

​
proxy_server
string | null

Proxy server url to route browser traffic through. Must include the protocol to use (e.g. http:// or https://)

​
proxy_username
string | null

Proxy server username.

​
proxy_password
string | null

Proxy server password.

Response

Task successfully submitted. The initial response may have a status of 'waiting'.

Task response model.

​
id
string
required

The ID of the task.

​
status
enum<string>
required

The status of the task.

Available options:
waiting,
running,
done,
failed
​
output
any

The output of the task.

​
credits_used
integer | null

The amount of credits used to perform the task.

​
device
enum<string> | null

The device type used for the task.

Available options:
desktop,
mobile
​
live_url
string | null

The URL to view and interact with the task execution.

​
recording_url
string | null

The URL to view the task recording.

⌘I