Skip to main content
POST
/
saved_tasks
Create a saved task
curl --request POST \
  --url https://browser.ai/api/v1/saved_tasks \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "MySavedTask",
  "instructions": [
    {
      "action": "Open amazon.com, search for AirPods Pro 2, and find the three best prices available"
    }
  ],
  "type": "natural_language",
  "cron_settings": "",
  "project": "Project_1",
  "geoLocation": {
    "country": "<string>",
    "city": "<string>",
    "zipcode": "<string>"
  }
}'
{
  "taskId": "<string>",
  "message": "Saved task created successfully"
}

Authorizations

​
Authorization
string
header
required

Insert API token, use the format: apikey <API-TOKEN>.

Body

application/json
​
name
string
required

Name of the saved task

Example:

"MySavedTask"

​
instructions
object[]
required

List of natural language actions

​
type
enum<string>
required

Type of the task. Currently only natural_language is supported.

Available options:
natural_language
Example:

"natural_language"

​
project
string
required

Project name or ID

Example:

"Project_1"

​
geoLocation
object
required
​
cron_settings
string

Cron expression for scheduling (leave empty for now)

Example:

""

Response

Saved task created successfully

​
taskId
string

ID of the saved task

​
message
string
Example:

"Saved task created successfully"