Actions

Execute browser action

Changed on

Executes a browser action on the session. Returns 200 if completed within wait_seconds, 202 if still in-flight.

Action types: navigate, observe, click, fill, select, press, scroll, wait_for, screenshot, batch.

post/browser_sessions/{id}/actions

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/browser_sessions/{id}/actions
  • Auth: HTTP bearer

Path parameters

idstring required

Query parameters

wait_secondsinteger

Maximum seconds the submission request waits for completion, not an execution timeout. If still queued or running, returns 202 without cancelling execution; poll the returned action ID.

Request body

OR
OR
OR
OR
OR
OR
OR
OR
OR

Response

Terminal action: succeeded, failed, or unknown. Inspect data.status and data.error; HTTP 200 does not imply successful execution.

Example response

{
  "data": {
    "id": "bact_075cfdc9-..."
  }
}

Changes