Skip to main content
GET
/
task
/
{task_id}
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task": "<string>",
  "live_url": "<string>",
  "output": "<string>",
  "status": "created",
  "created_at": "2023-11-07T05:31:56Z",
  "finished_at": "2023-11-07T05:31:56Z",
  "steps": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "step": 123,
      "evaluation_previous_goal": "<string>",
      "next_goal": "<string>",
      "url": "<string>"
    }
  ],
  "browser_data": {
    "cookies": [
      {}
    ]
  },
  "user_uploaded_files": [
    "<string>"
  ],
  "output_files": [
    "<string>"
  ],
  "public_share_url": "<string>",
  "metadata": {}
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
task_id
string<uuid>
required

Response

Successful Response

output: Final output or result of the task (if completed) live_url: URL to view live task execution. To preview the url you can directly integrate it in <iframe> tag. For example: <iframe src={live_url} width="600" height="450"></iframe> Which will display the task execution and allows you to control the agent live. It is pure VNC implementation.

browser_data: Browser session data from the task (cookies). To enable this feature, you need to set save_browser_data = True in the request.

​
id
string<uuid>
required
​
task
string
required
​
output
string | null
required
​
status
enum<string>
required

Enumeration of possible task states.

  • created: Task is initialized but not yet started
  • running: Task is currently executing
  • finished: Task has completed successfully
  • stopped: Task was manually stopped
  • paused: Task execution is temporarily paused
  • failed: Task encountered an error and could not complete
Available options:
created,
running,
finished,
stopped,
paused,
failed
​
created_at
string<date-time>
required
​
steps
TaskStepResponse · object[]
required
​
live_url
string | null
​
finished_at
string<date-time> | null
​
browser_data
object | null

cookies: List of cookies from the browser session

This field is only available if save_browser_data is set to True in the request.

​
user_uploaded_files
string[] | null
​
output_files
string[] | null
​
public_share_url
string | null
​
metadata
object | null
⌘I