Tasks
API Reference documentation section imported from BrowserAct Docs.
By Maggie1 author6 articles
- Run a bot (create a task) — POST /v3/bots/{bot_id}/runsStarts a new task execution for a published Bot and returns a `task_id`. ### How it works 1) Use `GET /v3/bots` to find a runnable Bot and copy its `bot_id`.…
- Retrieve a task status — GET /v3/bots/runs/{task_id}/statusReturns the current public status and update time for a task. This endpoint is more lightweight than `GET /v3/bots/runs/{task_id}` and is recommended for polling.
- Retrieve a task — GET /v3/bots/runs/{task_id}Returns comprehensive information about a task, including its current `status`, accepted `input`, output, failure details, files, live browser information, and Bot step summaries when available. Fields that do not apply…
- List tasks — GET /v3/bots/runsReturns a paginated list of Bot execution tasks. ### Filtering - Use `status` to filter by task status. - Use `bot_id` to list tasks created from a specific Bot. -…
- Resume a paused task — POST /v3/bots/runs/{task_id}/resumeRequests the resumption of a paused Bot task. SkillFlow tasks return error code `10879`; tasks that are not paused return `10127`. Resume is asynchronous, so the returned status can remain…
- Cancel a running task — POST /v3/bots/runs/{task_id}/cancelCancels a running or paused task. Optionally provide `biz_code`; when omitted, the default user-cancel code is used. A task already in a terminal state (`finished`, `canceled`, or `failed`) returns error…