/
CO
composiohq
/
Agent Orchestrator HTTP daemon
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 37m ago · Updated 1d ago
View markdown
composiohq
Agent Orchestrator HTTP daemon
post
Spawn a new agent session
latest
OpenAPI 3.1.0
raw.githubusercontent.com
2026-08-19
115
195
229.1 KB
cfefbf47dc04
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
43
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
List files in a session workspace with git change status
post
Clean up terminated session workspaces
settings
2
shellTerminals
4
usage
2
sessions
Spawn a new agent session
post
/api/v1/sessions
Request body
SpawnSessionRequest
required
attachments
AttachmentInput[]
branch
string
displayName
string
harness
'claude-code'
|
'codex'
|
'aider'
|
'opencode'
|
'grok'
|
'droid'
|
'amp'
|
'agy'
|
'crush'
|
'cursor'
|
'qwen'
|
'copilot'
|
'goose'
|
'auggie'
|
'continue'
|
'devin'
|
'cline'
|
'kimi'
|
'muse'
|
'kiro'
|
'kilocode'
|
'vibe'
|
'pi'
|
'kimchi'
|
'prime-agent'
|
'autohand'
issueId
string
kind
'worker'
|
'orchestrator'
mode
'chat'
|
'tui'
model
string
projectId
string
required
prompt
string
trackerProvider
'github'
|
'gitlab'
Response
Created
SpawnSessionResponse
required
promptBytes
integer
required
session
ControllersSessionView
required
systemPromptBytes
integer
required