/
CO
composiohq
/
Agent Orchestrator HTTP daemon
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 1h ago · Updated 8h ago
View markdown
composiohq
Agent Orchestrator HTTP daemon
post
Spawn an orchestrator session
latest
OpenAPI 3.1.0
raw.githubusercontent.com
2026-08-21
119
202
241.3 KB
ddec88a09a83
agents
5
browser
2
conversations
18
dev
1
events
1
import
2
mobile
8
notifications
4
projects
8
prs
2
push
3
reviews
10
sessions
44
get
List orchestrator sessions across projects
post
Spawn an orchestrator session
get
Fetch one orchestrator session
post
Start a worker task and ask the orchestrator to title it
get
List sessions
post
Spawn a new agent session
get
Fetch one session
patch
Rename a session display name
post
Report an agent activity-state signal for a session
get
List a session's durable agent-switch history
post
Submit a generation-fenced source-agent handoff
post
Retry safe source restoration for an agent switch
post
Write images into a running session's worktree and return their paths
patch
Set the automatic CI-failure injection default for new session PRs
patch
Set the auto-inject review setting for a session
put
Enable or disable automatic review for a session
get
Inspect TUI and Chat interface handoff support and progress
post
Switch a live session between its TUI and Chat controllers
delete
Cancel an interface handoff before its source controller stops
put
Acknowledge a failed or recovered interface handoff notice
post
Mark a session terminated and tear down runtime/workspace resources
patch
Configure whether PR completion terminates the session
post
Pin a session
delete
Unpin a session
get
List pull requests owned by a session
post
Claim an existing pull request for a session
get
Discover a browser preview URL for a session workspace
post
Set (or autodetect) the browser preview URL for a session
delete
Clear the browser preview URL for a session
get
Serve a static browser preview file from a session workspace
get
Get the managed preview server status for a session
post
Start a session-owned server from .ao/launch.json and open its application preview
delete
Stop the managed preview server for a session
post
Restore a terminated session
post
Resume an exited agent in its existing session
put
Set the reviewer harness for a session
post
Undo a partially-completed spawn (delete seed row, or kill if spawn output exists)
post
Send a message to a running session's agent
post
Switch a logical AO session to another agent harness
get
Stream session workspace file changes
get
Read one session workspace file and its git diff
get
Read one side of a session workspace image file
get
List files in a session workspace with git change status
post
Clean up terminated session workspaces
settings
2
shellTerminals
4
system
3
usage
2
sessions
Spawn an orchestrator session
post
/api/v1/orchestrators
Request body
SpawnOrchestratorRequest
required
clean
boolean
mode
'chat'
|
'tui'
projectId
string
required
Response
Created
SpawnOrchestratorResponse
required
orchestrator
OrchestratorResponse
required