Sign in

v1

latestOpenAPI 3.0.02026-07-26300209.6 KB
Automation

Start automation asynchronously

Creates and enqueues an automation run, returning the run_id immediately without waiting for completion. Use this for long-running automations where you want to poll for results separately.

post/v1/automation/run-async

Request body

urlstring uri required

Target website URL to automate

goalstring required

Natural language description of what to accomplish on the website

browser_profile'lite' | 'stealth'

Browser profile for execution. LITE uses standard browser, STEALTH uses anti-detection browser.

api_integrationstring

Name of the integration making this API call (e.g., "dify", "zapier", "n8n"). Used for analytics.

webhook_urlstring uri

HTTPS URL to receive webhook notifications for run lifecycle events. Must use HTTPS.

use_vaultboolean

Opt-in to vault credentials for this run. When true, enabled vault items are included. Defaults to false.

use_profileboolean

Opt-in to the default Browser Context Profile if Browser Context Profiles are enabled; legacy callers are silently ignored when the profiles feature is disabled. Returns 400 when enabled but no default profile is set.

profile_idstring

Browser Context Profile ID to use when use_profile is true.

credential_item_idsstring[]

Scope vault credentials to specific credential URIs. Requires use_vault to be true. If omitted with use_vault: true, all enabled items are used.

output_schemaobject

Optional provider-supported structured-output schema subset for the run result. Unsupported fields are rejected before the request is accepted.

Example request

{
  "url": "https://example.com",
  "goal": "Find the pricing page and extract all plan details",
  "browser_profile": "lite",
  "api_integration": "dify",
  "agent_config": {
    "mode": "strict",
    "cursor_style": "standard",
    "max_steps": 50,
    "max_duration_seconds": 300
  },
  "use_vault": true,
  "use_profile": true,
  "profile_id": "prof_abc123def4567890",
  "credential_item_ids": [
    "cred:conn-abc:Work:item-123",
    "cred:conn-def:Personal:item-456"
  ],
  "proxy_config": {
    "enabled": true,
    "country_code": "US"
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "title": {
        "type": "string"
      },
      "price": {
        "type": "number"
      }
    },
    "required": [
      "title",
      "price"
    ]
  }
}

Response

Run created and enqueued successfully. Returns run_id immediately. The automation will execute asynchronously.

run_idstring nullable required

Unique identifier for the created automation run

Example response

{
  "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error"
  }
}