Skip to main content
POST
/
v1
/
automation
/
run-batch
Start multiple automations asynchronously
curl --request POST \
  --url https://agent.tinyfish.ai/v1/automation/run-batch \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "runs": [
    {
      "url": "https://example.com",
      "goal": "Find the pricing page and extract all plan details",
      "browser_profile": "lite",
      "proxy_config": {
        "enabled": true,
        "country_code": "US"
      },
      "is_stress_test": true,
      "api_integration": "dify",
      "feature_flags": {
        "enable_agent_memory": true
      },
      "use_vault": true,
      "credential_item_ids": [
        "item_abc123",
        "item_def456"
      ]
    }
  ]
}
'
{
  "run_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f23456789012"
  ],
  "error": null
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get your key from the API Keys page.

Body

application/json

Batch of automation task configurations

​
runs
object[]
required

Array of run configurations (1-100)

Required array length: 1 - 100 elements

Response

All runs created and enqueued successfully.

Batch async run response. Run creation is atomic. Returns run_ids on success, error on failure.

​
run_ids
string[] | null
required

Created run IDs. Null if creation failed.

Example:
[
  "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "b2c3d4e5-f6a7-8901-bcde-f23456789012"
]
​
error
object
required

Error details. Null if successful.