V3 Bots

Create a run from an official template

Creates a Workflow or Agent run from a published official template. MCP execution context is not supported for template runs.

post/v3/bots/templates/{template_id}/runs

Request

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

Path parameters

template_idstring required

Public official template identifier.

Request body

inputobject required

Run input object. Its shape must conform to the template input_schema; use an empty object when no inputs are required.

proxy_regionstring

Optional proxy region code returned by the regions endpoint.

callback_urlstring uri

HTTP or HTTPS endpoint notified when the run reaches a terminal status. Private and local addresses are not allowed.

status_change_callback_urlstring uri

HTTP or HTTPS endpoint notified after each public run status change. Private and local addresses are not allowed.

Example request

{
  "proxy_region": "US"
}

Response

Template run created.

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

Initial public run status.

task_idstring required

Public run task identifier.

Changes

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