Web Tools

Act on an open browser session

Runs actions against an open session and returns the outputs of the resulting state. The refs from controls are what you act on. HTTP supports the same Bearer API key and shared credits as MCP, or an independent x402 wallet payment.

post/web/v1/act

Request

  • Base URL: https://api.oassis.dev
  • URL: https://api.oassis.dev/web/v1/act
  • Auth: one of:
    • HTTP bearer
    • none

Request body

sessionIdstring required

The session to act on, from web_session_open.

formatsstring[]

Outputs you want in the same response. controls is the map of what can be clicked; elements needs selectors; json needs json.prompt or json.schema.

selectorsstring[]

CSS selectors for the elements format.

maxAgeinteger

Accept an answer up to this many milliseconds old. A cache hit costs $0.0002 instead of the format price. Leave it out to force a fresh render.

binaryAs'base64'

How a screenshot or a PDF comes back. base64 is the only value today.

Response

success: true when every action ran · actions: what ran and where it stopped · data: one key per requested format of the state after acting

Changes

No recorded changes to this operation across all 1 revision of this API.