---
title: "Spawn an orchestrator session"
method: POST
path: "/api/v1/orchestrators"
tags: ["sessions"]
---

# Spawn an orchestrator session

`POST /api/v1/orchestrators`

## Request body

- SpawnOrchestratorRequest
  - `approvalMode` 'default' | 'accept-edits' | 'auto' | 'bypass-permissions'
  - `clean` boolean
  - `mode` 'chat' | 'tui'
  - `projectId` string, required

## Response `201`

Created

- SpawnOrchestratorResponse
  - `orchestrator` OrchestratorResponse, required
    - `id` string, required
    - `projectId` string, required
    - `projectName` string

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error
- `501` — Not Implemented

## Changes

- **2026-09-19** `4473efc5dd3f` — 1 info
  - added the new optional request property `approvalMode`
- **2026-09-03** `d31a2d019c47` — 4 info
  - added the optional property `reporting_owner` to the response with the `400` status
  - added the optional property `reporting_owner` to the response with the `404` status
  - added the optional property `reporting_owner` to the response with the `500` status
  - added the optional property `reporting_owner` to the response with the `501` status
- **2026-08-06** `d8396ad2c721` — 1 info
  - added the new optional request property `mode`

[Change history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/orchestrators/post.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/cfaec3fcda51?raw)