Skip to main content
POST
/
api
/
v1
/
add_example
Add Example
curl --request POST \
  --url https://api.example.com/api/v1/add_example \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "automation": {
    "url": "<string>",
    "parameters": {
      "input_parameters": {},
      "generated_parameters": {},
      "secure_parameters": {}
    },
    "nodes": [
      {
        "type": "<string>",
        "interaction_action": {
          "max_tries": 10,
          "max_timeout_seconds_per_try": 1,
          "click_element": {
            "prompt_instructions": "<string>",
            "xpath": "<string>",
            "command": "<string>",
            "skip_command": false,
            "skip_prompt": false,
            "assert_locator_presence": false,
            "double_click": false,
            "expect_download": false,
            "download_filename": "<string>"
          },
          "input_text": {
            "prompt_instructions": "<string>",
            "xpath": "<string>",
            "command": "<string>",
            "skip_command": false,
            "skip_prompt": false,
            "assert_locator_presence": false,
            "input_text": "<string>",
            "is_slider": false,
            "fill_or_type": "fill",
            "press_enter": false
          },
          "select_option": {
            "prompt_instructions": "<string>",
            "select_values": [
              "<string>"
            ],
            "xpath": "<string>",
            "command": "<string>",
            "skip_command": false,
            "skip_prompt": false,
            "assert_locator_presence": false,
            "expect_download": false,
            "download_filename": "<string>"
          },
          "check": {
            "prompt_instructions": "<string>",
            "xpath": "<string>",
            "command": "<string>",
            "skip_command": false,
            "skip_prompt": false,
            "assert_locator_presence": false
          },
          "uncheck": {
            "prompt_instructions": "<string>",
            "xpath": "<string>",
            "command": "<string>",
            "skip_command": false,
            "skip_prompt": false,
            "assert_locator_presence": false
          },
          "download_url_as_pdf": {
            "download_filename": "<string>",
            "url": "<string>"
          },
          "scroll": {
            "down": true
          },
          "upload_file": {
            "prompt_instructions": "<string>",
            "file_path": "<string>",
            "xpath": "<string>",
            "command": "<string>",
            "skip_command": false,
            "skip_prompt": false,
            "assert_locator_presence": false
          },
          "go_to_url": {
            "url": "<string>",
            "new_tab": false
          },
          "go_back": {},
          "switch_tab": {
            "tab_index": 123
          },
          "close_current_tab": {},
          "close_all_but_last_tab": {},
          "close_tabs_until": {
            "matching_url": "<string>",
            "tab_index": 123
          },
          "agentic_task": {
            "task": "<string>",
            "max_steps": 123,
            "backend": "browser_use",
            "use_vision": false,
            "keep_alive": true
          },
          "close_overlay_popup": {
            "task": "\nThe primary goal of this task is to **automatically dismiss obstructing overlay popups** to enable a human-like, unobstructed view and interaction with the main website content.\n\n---\n\n### šŸŽÆ Goal\nClear the entire viewport of any modal, overlay, or blocking element that prevents access to the underlying webpage content.\n\n### šŸ“œ Scope of Target Overlays\nTarget elements include, but are not limited to, the following common types of overlays:\n* Cookie Consent Banners/Modals\n* Privacy Policy Notices\n* Email/Newsletter Sign-up Prompts\n* Age Verification Gates\n* Blocking Promotional Offers\n\n### āš™ļø Action Priority and Rules\n\nThe agent must only dismiss overlays that a typical human user would close to proceed with the site. The actions must follow these specific rules in order of priority:\n\n1.  **Cookie Consent:** When encountering a cookie or privacy consent overlay, **always accept** or agree to the policy. Click buttons labeled \"Accept,\" \"Agree,\" \"Got it,\" \"Allow All,\" or similar positive confirmation phrases.\n2.  **General Dismissal:** For all other overlays (sign-ups, promotions, etc.), prioritize clicking **dismissive buttons** that close the popup without requiring user input. Look for labels like \"Close,\" \"X\" (close icon), \"No Thanks,\" \"Maybe Later,\" \"Skip,\" or \"Continue to site.\"\n3.  **Avoidance:** Do **not** input text, or click buttons like \"Sign Up,\" \"Learn More,\" or links that navigate away from the current page (e.g., \"Read Full Policy\"). The goal is solely to dismiss the current obstruction.\n\n### šŸ›‘ Completion State\nThe task is considered complete when the main body of the webpage is fully visible and ready for a user to interact with, meaning **no active overlays** are obstructing the content.\n",
            "max_steps": 5,
            "backend": "browser_use",
            "use_vision": true,
            "keep_alive": true
          },
          "key_press": {
            "type": "Enter"
          }
        },
        "assertion_action": {
          "network_call": {
            "url_pattern": "<string>",
            "header_filter": {}
          },
          "llm": {
            "extraction_instructions": "<string>",
            "source": [
              "screenshot"
            ],
            "extraction_format": {
              "assertion_result": "bool",
              "assertion_reason": "str"
            },
            "output_variable_names": [
              "<string>"
            ],
            "llm_provider": "gemini",
            "llm_model_name": "gemini-2.5-flash"
          },
          "python_script": {
            "script": "<string>"
          }
        },
        "extraction_action": {
          "unique_identifier": "<string>",
          "network_call": {
            "url_pattern": "<string>",
            "extract_from": "request",
            "download_from": "request",
            "download_filename": "<string>"
          },
          "llm": {
            "extraction_format": {},
            "extraction_instructions": "<string>",
            "source": [
              "axtree"
            ],
            "output_variable_names": [
              "<string>"
            ],
            "llm_provider": "gemini",
            "llm_model_name": "gemini-2.5-flash"
          },
          "python_script": {
            "script": "<string>"
          },
          "screenshot": {
            "filename": "<string>",
            "full_page": true
          },
          "state": {}
        },
        "python_script_action": {
          "execution_code": "<string>"
        },
        "two_fa_action": {
          "action": {
            "type": "<string>",
            "receiver_email_address": "<string>",
            "sender_email_address": "<string>"
          },
          "output_variable_name": "<string>",
          "instructions": "<string>",
          "max_wait_time": 300,
          "check_interval": 10
        },
        "before_sleep_time": 0,
        "end_sleep_time": 5,
        "expect_new_tab": false,
        "max_new_tab_wait_time": 0,
        "localized_axtree_string": "<string>"
      }
    ],
    "browser_channel": "chromium",
    "expected_downloads": 0,
    "remove_empty_nodes_in_axtree": true,
    "automation_description": "<string>",
    "automation_endpoint": "<string>"
  },
  "description": "<string>",
  "endpoint_name": "<string>"
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Headers

x-api-key
string
required

Body

application/json
automation
Automation Ā· object
required
description
string
required
endpoint_name
string
required

Response

Successful Response