Open Agent Harness Start

API surface

A stable contract for every client surface.

WebUI, TUI, Desktop, and external integrations should all talk to the same runtime API. Start with the reference, then drill into resources and schemas as needed.

GET /workspaces
POST /sessions
POST /runs
GET /runs/{id}/events
REST Resource operations

Use predictable endpoints for workspaces, sessions, runs, actions, files, models, and storage.

SSE Runtime stream

Subscribe to execution progress and state changes without making clients own the engine loop.

JSON Schema Config validation

Validate workspace settings, actions, hooks, model providers, prompts, and server configuration.

Resource Workspaces

Create, inspect, and operate durable workspace records.

Resource Sessions

Group user-visible interaction state around workspaces.

Resource Runs

Submit and track agent execution loops.

Resource Actions

Expose tool-like actions through the runtime contract.

Resource Files

Coordinate file access and workspace artifacts.

Resource Streaming

Consume progress and state changes over SSE.