API reference
The webagent HTTP API. Base URL, authentication, errors and every public endpoint by group.
The webagent API is a JSON REST API. Everything you can do in the dashboard goes through it, and so does the MCP server. The pages in this section are generated from the API's own OpenAPI description, so they match the code.
Base URL
https://api.us.webagent.lookover.aiThe examples in these docs write the base URL as <API_URL>. Replace it with the host of your stack.
Public host not live yet
The public API host above is the planned address and is not live yet. Until it is, use the URL of the stack you were given,
or http://localhost:4400 against a local stack. Every path below is the same on any host.
Authentication
Create an API key in the dashboard (it looks like wa_us_ followed by 43 characters) and send it as a Bearer token:
curl <API_URL>/v1/sessions \
-H "Authorization: Bearer wa_us_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"The x-api-key header carries the same key and works too. Keep keys on the server side; a key can do everything its
project can. Endpoints that list a session cookie are for the dashboard itself, you use a key.
Requests and responses
- Bodies are JSON (
Content-Type: application/json). - Create calls accept an
Idempotency-Keyheader. Send the same key and body again to get the first answer back instead of a second resource. - Lists that page return
{ items, nextCursor? }; passnextCursorback ascursor.
Errors
Every error has the same body and an HTTP status:
{ "error": { "code": "not_found", "message": "Human-readable text", "requestId": "..." } }code is stable and meant for your code; message is for people. See Errors for every code.
Endpoints
Pick a group in the sidebar. Each page lists the operations of one group, with parameters, request body, responses and
example code. Running a task inside a session is not an endpoint here: use the run_task tool of the MCP server.