api-v-2-workflow-controller

Start a new official template task execution

Initiates a Workflow or Skill official template task with specified parameters and returns the task identifier.

post/v2/workflow/run-task-by-template

Request

  • Base URL: https://api.browseract.com
  • URL: https://api.browseract.com/v2/workflow/run-task-by-template
  • Auth: HTTP bearer

Request body

proxyRegionstring

Optional. Region where the proxy should be used. default US

workflow_template_idstring

The official template to run.

callback_urlstring

Optional. HTTP/HTTPS URL to receive task completion notifications. The system will send a POST request with task results when the task finishes, fails, or is canceled. Maximum length: 2048 characters. Cannot point to private/local addresses.

status_change_callback_urlstring

Optional. HTTP/HTTPS URL to receive task status change notifications. The system will send a POST request with task results when the task's status change, such as running, finished, canceled, paused, failed. Maximum length: 2048 characters. Cannot point to private/local addresses.

Example request

{
  "proxyRegion": "US",
  "callback_url": "https://your-server.com/webhooks/workflow-callback",
  "status_change_callback_url": "https://your-server.com/webhooks/task-status-change-callback"
}

Response

OK

Changes

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