Gateway API Reference

Full HTTP + WebSocket surface of the OpenVesper gateway. Default bind:127.0.0.1:18789.

Agent execution

MethodPathPurpose
POST/agentSync run, returns full reply
POST/agent/asyncAsync run, returns {runId, acceptedAt}
POST/agent/streamSSE streaming
GET/agent/run/:runIdRun status
POST/agent/run/:runId/waitBlock until done
POST/agent/run/:runId/abortCancel

Routing & delegation

MethodPath
POST/agent/route
GET/agent/routes
POST/agent/delegate
POST/agent/handoff
POST/agent/subagents
POST/agent/:agent/context

Sessions

MethodPath
GET/sessions
GET/sessions/:key
POST/sessions/:key/reset
POST/sessions/:key/agent
POST/sessions/:key/compact
GET/sessions/:key/tokens
GET/sessions/:key/queue
POST/sessions/:key/queue/mode
POST/sessions/:key/fork
POST/sessions/:key/branch

Tasks, commitments, standing orders, approvals

MethodPath
GET/POST/tasks
DELETE/tasks/:id
GET/POST/standing-orders
DELETE/toggle/standing-orders/:id
GET/POST/commitments
POST/commitments/:id/fulfill
POST/commitments/:id/cancel
GET/approvals/pending
POST/approvals/:id/decide
GET/POST/approvals/rules
DELETE/approvals/rules/:index

Memory

MethodPath
GET/POST/memory/:agent
POST/memory/:agent/search
DELETE/memory/:agent/:id
DELETE/memory/:agent (clear all)

OAuth, audit, diagnostics

MethodPath
POST/oauth/start
GET/oauth/tokens
GET/oauth/tokens/:provider
DELETE/oauth/tokens/:provider
GET/audit
GET/audit/stats
GET/audit/dates
GET/diag
POST/diag/export

Channels, workspaces, remote

MethodPath
GET/POST/channel-routes
POST/channel-routes/resolve
DELETE/channel-routes/:index
GET/POST/access
POST/access/check
DELETE/access/:index
POST/remote/instructions
GET/POST/workspaces
DELETE/workspaces/:name
GET/workspaces/:name/env

Heartbeat & health

MethodPath
GET/heartbeat/status
POST/heartbeat/reload
GET/lanes
GET/health
WS/ws