Skip to main content
POST
/
v1
/
sdk
/
run_action
Run an SDK action
curl --request POST \
  --url https://api.skyvern.com/v1/sdk/run_action \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "action": {
    "type": "ai_click",
    "selector": "",
    "intention": "",
    "data": "<string>",
    "timeout": 10000
  },
  "browser_session_id": "<string>",
  "browser_address": "<string>",
  "workflow_run_id": "<string>"
}
'
{
  "workflow_run_id": "<string>",
  "result": "<unknown>"
}

Headers

​
x-api-key
string | null

Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

Body

application/json

Request to run a single SDK action.

​
url
string
required

The URL where the action should be executed

​
action
ClickAction · object
required

Click action parameters.

​
browser_session_id
string | null

The browser session ID

​
browser_address
string | null

The browser address

​
workflow_run_id
string | null

Optional workflow run ID to continue an existing workflow run

Response

Successful Response

Response from running an SDK action.

​
workflow_run_id
string
required

The workflow run ID used for this action

​
result
any | null

The result from the action (e.g., selector, value, extracted data)