---
title: "Changes to Spawn a new agent session"
method: POST
path: "/api/v1/sessions"
---

# Changes to Spawn a new agent session

`POST /api/v1/sessions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 28 of 108 revisions.

- **2026-08-30** `740f56983ade` — 2 info
- **2026-08-27** `2ecc6c3f5734` — 1 info
- **2026-08-24** `70e37be821e3` — 1 info
- **2026-08-19** `cfefbf47dc04` — 2 info
- **2026-08-14** `ad03d2ec1b20` — 1 info
- **2026-08-13** `71905b90713b` — 1 info
- **2026-08-13** `9c4458b5852c` — 1 info
- **2026-08-13** `1c746377fde5` — 1 info
- **2026-08-09** `be069344383f` — 1 info
- **2026-08-09** `25a4d3b59cf4` — 1 warning, 1 info
- **2026-08-08** `0754881ee8f4` — 1 info
- **2026-08-07** `6ffec0ec12f0` — 21 warning
- **2026-08-06** `3b56a74269ca` — 1 info
- **2026-08-06** `d8396ad2c721` — 2 info
- **2026-08-04** `352bbca50f98` — 2 info
- **2026-08-04** `f4fd1a6add81` — 1 info
- **2026-08-04** `5758f4dd3544` — 1 breaking
- **2026-07-24** `d202268a973f` — 1 warning, 2 info
- **2026-07-23** `51074d514c16` — 2 info
- **2026-07-22** `474723d6f99b` — 1 info
- **2026-07-22** `d97fb88e7ffe` — 1 info
- **2026-06-30** `c3b36a940fed` — 1 info
- **2026-06-22** `31605d9fa5c7` — 1 info
- **2026-06-21** `a6f82f51cdbc` — 1 info
- **2026-06-21** `09193e178bfe` — 26 warning
- **2026-06-21** `f415a0cf3d25` — 1 info
- **2026-06-17** `b0d782fa248a` — 1 info
- **2026-06-10** `b64f5ab46d87` — 1 breaking, 4 warning, 13 info

## Changes

- **2026-08-30** `740f56983ade` — 2 info
  - added the required property `session/displayStatus` to the response with the `201` status
  - added the required property `session/kanbanColumn` to the response with the `201` status
- **2026-08-27** `2ecc6c3f5734` — 1 info
  - added the optional property `session/lastUserMessageAt` to the response with the `201` status
- **2026-08-24** `70e37be821e3` — 1 info
  - added the new `omp` enum value to the request property `harness`
- **2026-08-19** `cfefbf47dc04` — 2 info
  - added the new optional request property `model`
  - added the optional property `session/model` to the response with the `201` status
- **2026-08-14** `ad03d2ec1b20` — 1 info
  - added the optional property `session/activeAgentSwitch` to the response with the `201` status
- **2026-08-13** `71905b90713b` — 1 info
  - added the required property `session/autoReviewEnabled` to the response with the `201` status
- **2026-08-13** `9c4458b5852c` — 1 info
  - added the new optional request property `trackerProvider`
- **2026-08-13** `1c746377fde5` — 1 info
  - added the required property `session/autoInjectCI` to the response with the `201` status
- **2026-08-09** `be069344383f` — 1 info
  - added the required property `session/autoInjectReview` to the response with the `201` status
- **2026-08-09** `25a4d3b59cf4` — 1 warning, 1 info
  - added the new `kimchi` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `kimchi` enum value to the request property `harness`
- **2026-08-08** `0754881ee8f4` — 1 info
  - added the new `prime-agent` enum value to the request property `harness`
- **2026-08-07** `6ffec0ec12f0` — 21 warning
  - added the new `agy` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `aider` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `amp` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `auggie` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `autohand` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `cline` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `continue` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `copilot` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `crush` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `cursor` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `devin` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `droid` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `goose` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `grok` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `kilocode` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `kimi` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `kiro` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `muse` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `pi` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `qwen` enum value to the `session/reviewerHarness` response property for the response status `201`
  - added the new `vibe` enum value to the `session/reviewerHarness` response property for the response status `201`
- **2026-08-06** `3b56a74269ca` — 1 info
  - added the new `muse` enum value to the request property `harness`
- **2026-08-06** `d8396ad2c721` — 2 info
  - added the new optional request property `mode`
  - added the required property `session/mode` to the response with the `201` status
- **2026-08-04** `352bbca50f98` — 2 info
  - added the optional property `session/pinnedAt` to the response with the `201` status
  - added the required property `session/isPinned` to the response with the `201` status
- **2026-08-04** `f4fd1a6add81` — 1 info
  - added the optional property `session/reviewerHarness` to the response with the `201` status
- **2026-08-04** `5758f4dd3544` — 1 breaking
  - removed the enum value `fake` of the request property `harness`
- **2026-07-24** `d202268a973f` — 1 warning, 2 info
  - added the new `exited` enum value to the `session/status` response property for the response status `201`
  - added the optional property `session/scmStatus` to the response with the `201` status
  - added the required property `session/terminateOnPrMerge` to the response with the `201` status
- **2026-07-23** `51074d514c16` — 2 info
  - added the required property `promptBytes` to the response with the `201` status
  - added the required property `systemPromptBytes` to the response with the `201` status
- **2026-07-22** `474723d6f99b` — 1 info
  - added the new optional request property `attachments`
- **2026-07-22** `d97fb88e7ffe` — 1 info
  - added the new `fake` enum value to the request property `harness`
- **2026-06-30** `c3b36a940fed` — 1 info
  - added the new optional request property `displayName`
- **2026-06-22** `31605d9fa5c7` — 1 info
  - added the optional property `session/previewRevision` to the response with the `201` status
- **2026-06-21** `a6f82f51cdbc` — 1 info
  - added the optional property `session/previewUrl` to the response with the `201` status
- **2026-06-21** `09193e178bfe` — 26 warning
  - added the new `approved` enum value to the `session/prs/items/review` response property for the response status `201`
  - added the new `approved` enum value to the `session/status` response property for the response status `201`
  - added the new `blocked` enum value to the `session/prs/items/mergeability` response property for the response status `201`
  - added the new `changes_requested` enum value to the `session/prs/items/review` response property for the response status `201`
  - added the new `changes_requested` enum value to the `session/status` response property for the response status `201`
  - added the new `ci_failed` enum value to the `session/status` response property for the response status `201`
  - added the new `conflicting` enum value to the `session/prs/items/mergeability` response property for the response status `201`
  - added the new `draft` enum value to the `session/status` response property for the response status `201`
  - added the new `failing` enum value to the `session/prs/items/ci` response property for the response status `201`
  - added the new `idle` enum value to the `session/status` response property for the response status `201`
  - added the new `mergeable` enum value to the `session/prs/items/mergeability` response property for the response status `201`
  - added the new `mergeable` enum value to the `session/status` response property for the response status `201`
  - added the new `merged` enum value to the `session/status` response property for the response status `201`
  - added the new `needs_input` enum value to the `session/status` response property for the response status `201`
  - added the new `no_signal` enum value to the `session/status` response property for the response status `201`
  - added the new `none` enum value to the `session/prs/items/review` response property for the response status `201`
  - added the new `passing` enum value to the `session/prs/items/ci` response property for the response status `201`
  - added the new `pending` enum value to the `session/prs/items/ci` response property for the response status `201`
  - added the new `pr_open` enum value to the `session/status` response property for the response status `201`
  - added the new `review_pending` enum value to the `session/status` response property for the response status `201`
  - added the new `review_required` enum value to the `session/prs/items/review` response property for the response status `201`
  - added the new `terminated` enum value to the `session/status` response property for the response status `201`
  - added the new `unknown` enum value to the `session/prs/items/ci` response property for the response status `201`
  - added the new `unknown` enum value to the `session/prs/items/mergeability` response property for the response status `201`
  - added the new `unstable` enum value to the `session/prs/items/mergeability` response property for the response status `201`
  - added the new `working` enum value to the `session/status` response property for the response status `201`
- **2026-06-21** `f415a0cf3d25` — 1 info
  - added the optional property `session/branch` to the response with the `201` status
- **2026-06-17** `b0d782fa248a` — 1 info
  - added the required property `session/prs` to the response with the `201` status
- **2026-06-10** `b64f5ab46d87` — 1 breaking, 4 warning, 13 info
  - removed the required property `session/prs` from the response with the `201` status
  - removed the request property `displayName`
  - removed the optional property `session/branch` from the response with the `201` status
  - removed the optional property `session/previewRevision` from the response with the `201` status
  - removed the optional property `session/previewUrl` from the response with the `201` status
  - removed the `approved` enum value from the `session/status` response property for the response status `201`
  - removed the `changes_requested` enum value from the `session/status` response property for the response status `201`
  - removed the `ci_failed` enum value from the `session/status` response property for the response status `201`
  - removed the `draft` enum value from the `session/status` response property for the response status `201`
  - removed the `idle` enum value from the `session/status` response property for the response status `201`
  - removed the `mergeable` enum value from the `session/status` response property for the response status `201`
  - removed the `merged` enum value from the `session/status` response property for the response status `201`
  - removed the `needs_input` enum value from the `session/status` response property for the response status `201`
  - removed the `no_signal` enum value from the `session/status` response property for the response status `201`
  - removed the `pr_open` enum value from the `session/status` response property for the response status `201`
  - removed the `review_pending` enum value from the `session/status` response property for the response status `201`
  - removed the `terminated` enum value from the `session/status` response property for the response status `201`
  - removed the `working` enum value from the `session/status` response property for the response status `201`

---

[Operation](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/docs/api/v1/sessions/post.md) · [API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) · [Page](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/sessions/post)
