/
CO
composiohq
/
Agent Orchestrator HTTP daemon
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 2h ago · Updated 4h ago
View markdown
composiohq
Agent Orchestrator HTTP daemon
post
Spawn a new agent session
v
OpenAPI 3.1.0
raw.githubusercontent.com
2026-08-09
97
170
192.5 KB
agents
5
browser
2
conversations
15
dev
1
events
1
import
2
mobile
4
notifications
4
projects
7
prs
2
push
2
reviews
8
sessions
36
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
post
Write images into a running session's worktree and return their paths
patch
Set the auto-inject review setting 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
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
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
ControllersSpawnAttachmentInput[]
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'
projectId
string
required
prompt
string
Response
Created
SpawnSessionResponse
required
promptBytes
integer
required
session
ControllersSessionView
required
systemPromptBytes
integer
required