---
title: "Changes to Create a session"
method: POST
path: "/api/v0/sessions"
---

# Changes to Create a session

`POST /api/v0/sessions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 25 of 34 revisions.

- **2026-09-26** `a11cdfab8da6` — 6 warning, 6 info
- **2026-09-25** `b73121146c95` — 1 info
- **2026-09-23** `4c7a84680cd4` — 4 warning, 4 info
- **2026-09-22** `415bff082e81` — 3 warning, 3 info
- **2026-09-18** `15889611fbe2` — 2 warning, 2 info
- **2026-09-17** `932e1abfde8e` — 2 warning, 2 info
- **2026-09-15** `2b31c104e8d7` — 1 info
- **2026-09-10** `231a06e02440` — 1 warning, 1 info
- **2026-09-09** `b8a9b7beab68` — 2 warning
- **2026-09-05** `5e5ad4346c29` — 1 warning, 1 info
- **2026-09-04** `f01f903dba1f` — 1 warning, 1 info
- **2026-09-02** `2b47cb33d833` — 1 warning, 1 info
- **2026-08-29** `8a9f1c4e20ac` — 17 breaking, 1 warning, 18 info
- **2026-08-27** `f17d1a188282` — 1 warning, 1 info
- **2026-08-22** `34857551f3dc` — 10 warning, 1 info
- **2026-08-19** `46e6b43ae479` — 1 info
- **2026-08-18** `613cb60e57ba` — 2 info
- **2026-08-15** `b742f55c9840` — 2 warning, 4 info
- **2026-08-13** `36e0c5cc926b` — 1 warning, 1 info
- **2026-08-12** `5ee8657e0932` — 1 warning, 7 info
- **2026-08-11** `0effac11309f` — 1 warning, 1 info
- **2026-08-04** `b2cbc420029f` — 1 warning, 1 info
- **2026-08-01** `f31331a0620b` — 3 warning, 3 info
- **2026-07-31** `0383294a9870` — 1 warning, 1 info
- **2026-07-26** `749e76236673` — 8 warning, 12 info

## Changes

- **2026-09-26** `a11cdfab8da6` — 6 warning, 6 info
  - added the new `claude-sonnet-5-5` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-5.6-luna-flex` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-5.6-terra-flex` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-6-astra-flex` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-6-luna-flex` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-6-sol-flex` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `claude-sonnet-5-5` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-5.6-luna-flex` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-5.6-terra-flex` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-6-astra-flex` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-6-luna-flex` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-6-sol-flex` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-09-25** `b73121146c95` — 1 info
  - added the optional property `artifacts` to the response with the `201` status
- **2026-09-23** `4c7a84680cd4` — 4 warning, 4 info
  - added the new `gpt-6-luna` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-6-sol` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-image-2.5-flare` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-image-2.5-sunburst` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-6-luna` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-6-sol` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-image-2.5-flare` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-image-2.5-sunburst` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-09-22** `415bff082e81` — 3 warning, 3 info
  - added the new `claude-opus-5-5` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `claude-opus-5-5-fast` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `grok-4.7` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `claude-opus-5-5` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `claude-opus-5-5-fast` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `grok-4.7` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-09-18** `15889611fbe2` — 2 warning, 2 info
  - added the new `mistral-medium-3.5` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `together` enum value to the `sessionSettings/apiProviderLock` response property for the response status `201`
  - added the new `mistral-medium-3.5` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `together` enum value to the request property `sessionSettings/apiProviderLock`
- **2026-09-17** `932e1abfde8e` — 2 warning, 2 info
  - added the new `azure_anthropic` enum value to the `sessionSettings/apiProviderLock` response property for the response status `201`
  - added the new `deepseek-v4.1-flash` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `azure_anthropic` enum value to the request property `sessionSettings/apiProviderLock`
  - added the new `deepseek-v4.1-flash` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-09-15** `2b31c104e8d7` — 1 info
  - added the optional property `parent_session_id` to the response with the `201` status
- **2026-09-10** `231a06e02440` — 1 warning, 1 info
  - added the new `qwen3.8-max` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `qwen3.8-max` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-09-09** `b8a9b7beab68` — 2 warning
  - removed the request property `sessionSettings/runInWorktree`
  - removed the optional property `sessionSettings/runInWorktree` from the response with the `201` status
- **2026-09-05** `5e5ad4346c29` — 1 warning, 1 info
  - added the new `gpt-6-astra` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-6-astra` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-09-04** `f01f903dba1f` — 1 warning, 1 info
  - added the new `gemini-3.8-flash` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gemini-3.8-flash` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-09-02** `2b47cb33d833` — 1 warning, 1 info
  - added the new `claude-fable-5.1` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `claude-fable-5.1` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-08-29** `8a9f1c4e20ac` — 17 breaking, 1 warning, 18 info
  - removed the enum value `agate-07-11` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `almond-05-27` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `amber-07-09` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `anise-06-16` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `aspen-05-15` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `gantry-05-07` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `ocelot-06-01` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `okappa-alpha` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `olive-05-22` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `olm-03-05` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `omaffa-alpha` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `orbit-04-09` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `oriel-06-01` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `owl-06-21` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `oxbow-06-01` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `oxide-06-01` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the enum value `titan-02-12` of the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `glm-5.3` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `glm-5.3` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - removed the `agate-07-11` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `almond-05-27` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `amber-07-09` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `anise-06-16` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `aspen-05-15` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `gantry-05-07` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `ocelot-06-01` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `okappa-alpha` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `olive-05-22` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `olm-03-05` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `omaffa-alpha` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `orbit-04-09` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `oriel-06-01` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `owl-06-21` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `oxbow-06-01` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `oxide-06-01` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - removed the `titan-02-12` enum value from the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
- **2026-08-27** `f17d1a188282` — 1 warning, 1 info
  - added the new `glm-5.3-flash` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `glm-5.3-flash` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-08-22** `34857551f3dc` — 10 warning, 1 info
  - removed the request property `sessionSettings/assistantActiveTimeMs`
  - removed the request property `sessionSettings/childInclusiveTokenUsageBySessionId`
  - removed the request property `sessionSettings/inclusiveTokenUsage`
  - removed the request property `sessionSettings/lastCallTokenUsage`
  - removed the request property `sessionSettings/tokenUsage`
  - removed the optional property `sessionSettings/assistantActiveTimeMs` from the response with the `201` status
  - removed the optional property `sessionSettings/childInclusiveTokenUsageBySessionId` from the response with the `201` status
  - removed the optional property `sessionSettings/inclusiveTokenUsage` from the response with the `201` status
  - removed the optional property `sessionSettings/lastCallTokenUsage` from the response with the `201` status
  - removed the optional property `sessionSettings/tokenUsage` from the response with the `201` status
  - added the optional property `factoryCredits` to the response with the `201` status
- **2026-08-19** `46e6b43ae479` — 1 info
  - added the new optional request property `sessionSettings/systemPrompt`
- **2026-08-18** `613cb60e57ba` — 2 info
  - added the new optional request property `sessionSettings/worktree/parentWorktreePath`
  - added the optional property `sessionSettings/worktree/parentWorktreePath` to the response with the `201` status
- **2026-08-15** `b742f55c9840` — 2 warning, 4 info
  - added the new `gemini-3.7-flash` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-transcribe` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new optional request property `sessionSettings/worktree`
  - added the new `gemini-3.7-flash` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-transcribe` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the optional property `sessionSettings/worktree` to the response with the `201` status
- **2026-08-13** `36e0c5cc926b` — 1 warning, 1 info
  - added the new `grok-4.6` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `grok-4.6` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-08-12** `5ee8657e0932` — 1 warning, 7 info
  - added the new `gpt-5.4-mini-fast` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new optional request property `sessionSettings/allowSubagentsInScripts`
  - added the new optional request property `sessionSettings/toolExecutionMode`
  - added the new `gpt-5.4-mini-fast` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the non-success response with the status `503`
  - added the non-success response with the status `504`
  - added the optional property `sessionSettings/allowSubagentsInScripts` to the response with the `201` status
  - added the optional property `sessionSettings/toolExecutionMode` to the response with the `201` status
- **2026-08-11** `0effac11309f` — 1 warning, 1 info
  - added the new `mistral` enum value to the `sessionSettings/apiProviderLock` response property for the response status `201`
  - added the new `mistral` enum value to the request property `sessionSettings/apiProviderLock`
- **2026-08-04** `b2cbc420029f` — 1 warning, 1 info
  - added the new `deepseek-v4-flash-0731` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `deepseek-v4-flash-0731` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-08-01** `f31331a0620b` — 3 warning, 3 info
  - added the new `gemini-3-pro-image-preview` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-image-2` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `inkling` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gemini-3-pro-image-preview` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gpt-image-2` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `inkling` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-07-31** `0383294a9870` — 1 warning, 1 info
  - added the new `gpt-5.6-sol-fast` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gpt-5.6-sol-fast` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
- **2026-07-26** `749e76236673` — 8 warning, 12 info
  - added the new `agate-07-11` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `aster-07-15` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `atlas-07-21` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `claude-opus-5` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `claude-opus-5-fast` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `garnet-07-15` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `gemini-3.6-flash` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new `kimi-k3` enum value to the `sessionSettings/compactionModel/anyOf[subschema #2]/` response property for the response status `201`
  - added the new optional request property `sessionSettings/lastCallTokenUsage`
  - added the new optional request property `sessionSettings/restrictToolIds`
  - added the new `agate-07-11` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `aster-07-15` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `atlas-07-21` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `claude-opus-5` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `claude-opus-5-fast` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `garnet-07-15` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `gemini-3.6-flash` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the new `kimi-k3` enum value to the request property `sessionSettings/compactionModel/anyOf[subschema #2]/`
  - added the optional property `sessionSettings/lastCallTokenUsage` to the response with the `201` status
  - added the optional property `sessionSettings/restrictToolIds` to the response with the `201` status

---

[Operation](https://skmtc.dev/factory/apis/factory-public-api/docs/api/v0/sessions/post.md) · [API](https://skmtc.dev/factory/apis/factory-public-api.md) · [Page](https://skmtc.dev/factory/apis/factory-public-api/changes/api/v0/sessions/post)
