/
CO
composiohq
/
Agent Orchestrator HTTP daemon
Search skmtc…
⌘K
Changes
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Updated on 2026-09-27
Details
Filter operations
agents
26
browser
2
conversations
28
dev
1
events
1
fs
1
github
4
identity
2
import
4
link-preview
1
mobile
9
notifications
6
projects
13
prs
2
push
3
reports
2
reviews
10
sessions
54
get
Resolve a session workspace for the loopback desktop supervisor
get
List orchestrator sessions across projects
post
Spawn an orchestrator session
get
Fetch one orchestrator session
post
Start a worker task and refine its title in the background
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 automatic CI-failure injection for a session and its PRs
patch
Set the auto-inject review setting for a session
put
Enable or disable automatic review for a session
post
Exit the agent while preserving its AO 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
get
Read one file from an associated pull request base-to-head diff
get
Read one text-capable side of a pull request comparison
get
List the exact base-to-head changed files for an associated pull request
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
post
Read grouped unified patches for a bounded set of workspace files
get
Stream session workspace file changes
get
Read one session workspace file and its git diff
put
Replace one existing text file in a session workspace
get
Read one side of a session workspace image file
get
Read one text-capable side of a workspace comparison
get
List files in a session workspace with git change status
get
Search visible workspace file paths
get
List one directory level of a session workspace's full file tree, git-status decorated
post
Clean up terminated session workspaces
settings
3
shellTerminals
4
system
5
usage
2
sessions
Spawn an orchestrator session
post
/api/v1/orchestrators
Request body
SpawnOrchestratorRequest
required
approvalMode
'default'
|
'accept-edits'
|
'auto'
|
'bypass-permissions'
clean
boolean
mode
'chat'
|
'tui'
projectId
string
required
Response
Created
SpawnOrchestratorResponse
required
orchestrator
OrchestratorResponse
required
Changes