Overview
The Page Agents API is a surface-agnostic proxy to the local Gizzi brain runtime for browser and page-agent workflows. It lets you start a goal-driven run, stream runtime events over SSE, stop an active run, and save runtime configuration. In Phase 1 the runtime target defaults tohttp://127.0.0.1:4096 and can be overridden with the ALLTERNIT_PAGE_AGENT_URL environment variable.
Base URL
Authentication
Page-agent routes are served through the gateway, so include a valid bearer token in theAuthorization header. See Authentication for details.
Endpoints
Start a run
Request body
Example request
Example response
Stream events
requestedSessionId so clients can correlate frames even when the upstream runtime does not include the session ID.