V3 Bots

Query a bot run

Returns the fixed public run detail contract. Workflow-only fields such as steps are omitted when unavailable; use the dedicated status endpoint for lightweight polling.

get/v3/bots/runs/{task_id}

Request

  • Base URL: https://api.browseract.com
  • URL: https://api.browseract.com/v3/bots/runs/{task_id}
  • Auth: HTTP bearer

Path parameters

task_idstring required

Public run task identifier.

Response

Run returned.

status'created' | 'running' | 'finished' | 'canceled' | 'pausing' | 'paused' | 'failed' required

Current public run status.

inputobject required

Input object accepted for this run.

outputobject

Run output conforming to the bot output_schema when an authoritative schema exists.

creditinteger

Credit cost of this run when available.

task_idstring required

Public run task identifier.

log_detail_urlstring uri required

BrowserAct page containing the detailed logs for this run.

bot_idstring

Public bot identifier used by a normal Bot run. Absent for an official template run.

bot_type'workflow' | 'agent' required

Public bot type used by this run.

bot_namestring

Bot display name when available for a normal Bot run. Absent for an official template run.

created_atstring date-time required

Run creation time.

finished_atstring date-time

Run terminal time.

output_filesobject

Business result files keyed by format, for example json, md, csv or xml. This is separate from files downloaded during execution.

files_expires_atinteger

Expiration timestamp for the run download files, in epoch milliseconds.

Changes

No recorded changes to this operation across all 1 revision of this API.