Skip to main content
POST
/
v1
/
automation
/
run-async
Start automation asynchronously
curl --request POST \
  --url https://mino.ai/v1/automation/run-async \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "url": "https://example.com",
  "goal": "Find the pricing page and extract all plan details",
  "browser_profile": "lite",
  "proxy_config": {
    "enabled": true,
    "country_code": "US"
  }
}
'
{
  "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "error": null
}

Authorizations

​
X-API-Key
string
header
required

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

Body

application/json

Automation task configuration

​
url
string<uri>
required

Target website URL to automate

Example:

"https://example.com"

​
goal
string
required

Natural language description of what to accomplish on the website

Minimum string length: 1
Example:

"Find the pricing page and extract all plan details"

​
browser_profile
enum<string>

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

Available options:
lite,
stealth
Example:

"lite"

​
proxy_config
object

Proxy configuration

Response

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

Async automation run response. Returns run_id immediately without waiting for completion.

​
run_id
string | null
required

Unique identifier for the created automation run

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
error
object
required

Error details. Null if successful.