Changes to Create a session

Changed in 25 of the 34 revisions of this API.▲17●53○76

1. Sep 26, 2026a11cdfab8da6●6○6
2. Sep 25, 2026b73121146c95○1
3. Sep 23, 20264c7a84680cd4●4○4
4. Sep 22, 2026415bff082e81●3○3
5. Sep 18, 202615889611fbe2●2○2
6. Sep 17, 2026932e1abfde8e●2○2
7. Sep 15, 20262b31c104e8d7○1
8. Sep 10, 2026231a06e02440●1○1
9. Sep 9, 2026b8a9b7beab68●2
10. Sep 5, 20265e5ad4346c29●1○1
11. Sep 4, 2026f01f903dba1f●1○1
12. Sep 2, 20262b47cb33d833●1○1
13. Aug 29, 20268a9f1c4e20ac▲17●1○18
14. Aug 27, 2026f17d1a188282●1○1
15. Aug 22, 202634857551f3dc●10○1
16. Aug 19, 202646e6b43ae479○1
17. Aug 18, 2026613cb60e57ba○2
18. Aug 15, 2026b742f55c9840●2○4
19. Aug 13, 202636e0c5cc926b●1○1
20. Aug 12, 20265ee8657e0932●1○7
21. Aug 11, 20260effac11309f●1○1
22. Aug 4, 2026b2cbc420029f●1○1
23. Aug 1, 2026f31331a0620b●3○3
24. Jul 31, 20260383294a9870●1○1
25. Jul 26, 2026749e76236673●8○12

What changed

• Sep 26, 2026a11cdfab8da6●6○6See the full diff
  • ●

    added the new claude-sonnet-5-5 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-5.6-luna-flex enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-5.6-terra-flex enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-6-astra-flex enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-6-luna-flex enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-6-sol-flex enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new claude-sonnet-5-5 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-5.6-luna-flex enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-5.6-terra-flex enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-6-astra-flex enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-6-luna-flex enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-6-sol-flex enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Sep 25, 2026b73121146c95○1See the full diff
  • ○

    added the optional property artifacts to the response with the 201 status

    response-optional-property-added

• Sep 23, 20264c7a84680cd4●4○4See the full diff
  • ●

    added the new gpt-6-luna enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-6-sol enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-image-2.5-flare enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-image-2.5-sunburst enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new gpt-6-luna enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-6-sol enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-image-2.5-flare enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-image-2.5-sunburst enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Sep 22, 2026415bff082e81●3○3See the full diff
  • ●

    added the new claude-opus-5-5 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new claude-opus-5-5-fast enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new grok-4.7 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new claude-opus-5-5 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new claude-opus-5-5-fast enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new grok-4.7 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Sep 18, 202615889611fbe2●2○2See the full diff
  • ●

    added the new mistral-medium-3.5 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new together enum value to the sessionSettings/apiProviderLock response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new mistral-medium-3.5 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new together enum value to the request property sessionSettings/apiProviderLock

    request-property-enum-value-added

• Sep 17, 2026932e1abfde8e●2○2See the full diff
  • ●

    added the new azure_anthropic enum value to the sessionSettings/apiProviderLock response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new deepseek-v4.1-flash enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new azure_anthropic enum value to the request property sessionSettings/apiProviderLock

    request-property-enum-value-added

  • ○

    added the new deepseek-v4.1-flash enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Sep 15, 20262b31c104e8d7○1See the full diff
  • ○

    added the optional property parent_session_id to the response with the 201 status

    response-optional-property-added

• Sep 10, 2026231a06e02440●1○1See the full diff
  • ●

    added the new qwen3.8-max enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new qwen3.8-max enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Sep 9, 2026b8a9b7beab68●2See the full diff
  • ●

    removed the request property sessionSettings/runInWorktree

    request-property-removed

  • ●

    removed the optional property sessionSettings/runInWorktree from the response with the 201 status

    response-optional-property-removed

• Sep 5, 20265e5ad4346c29●1○1See the full diff
  • ●

    added the new gpt-6-astra enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new gpt-6-astra enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Sep 4, 2026f01f903dba1f●1○1See the full diff
  • ●

    added the new gemini-3.8-flash enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new gemini-3.8-flash enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Sep 2, 20262b47cb33d833●1○1See the full diff
  • ●

    added the new claude-fable-5.1 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new claude-fable-5.1 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Aug 29, 20268a9f1c4e20ac▲17●1○18See the full diff
  • ▲

    removed the enum value agate-07-11 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value almond-05-27 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value amber-07-09 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value anise-06-16 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value aspen-05-15 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value gantry-05-07 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value ocelot-06-01 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value okappa-alpha of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value olive-05-22 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value olm-03-05 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value omaffa-alpha of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value orbit-04-09 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value oriel-06-01 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value owl-06-21 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value oxbow-06-01 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value oxide-06-01 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ▲

    removed the enum value titan-02-12 of the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-removed

  • ●

    added the new glm-5.3 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new glm-5.3 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    removed the agate-07-11 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the almond-05-27 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the amber-07-09 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the anise-06-16 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the aspen-05-15 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the gantry-05-07 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the ocelot-06-01 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the okappa-alpha enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the olive-05-22 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the olm-03-05 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the omaffa-alpha enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the orbit-04-09 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the oriel-06-01 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the owl-06-21 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the oxbow-06-01 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the oxide-06-01 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

  • ○

    removed the titan-02-12 enum value from the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-removed

• Aug 27, 2026f17d1a188282●1○1See the full diff
  • ●

    added the new glm-5.3-flash enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new glm-5.3-flash enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Aug 22, 202634857551f3dc●10○1See the full diff
  • ●

    removed the request property sessionSettings/assistantActiveTimeMs

    request-property-removed

  • ●

    removed the request property sessionSettings/childInclusiveTokenUsageBySessionId

    request-property-removed

  • ●

    removed the request property sessionSettings/inclusiveTokenUsage

    request-property-removed

  • ●

    removed the request property sessionSettings/lastCallTokenUsage

    request-property-removed

  • ●

    removed the request property sessionSettings/tokenUsage

    request-property-removed

  • ●

    removed the optional property sessionSettings/assistantActiveTimeMs from the response with the 201 status

    response-optional-property-removed

  • ●

    removed the optional property sessionSettings/childInclusiveTokenUsageBySessionId from the response with the 201 status

    response-optional-property-removed

  • ●

    removed the optional property sessionSettings/inclusiveTokenUsage from the response with the 201 status

    response-optional-property-removed

  • ●

    removed the optional property sessionSettings/lastCallTokenUsage from the response with the 201 status

    response-optional-property-removed

  • ●

    removed the optional property sessionSettings/tokenUsage from the response with the 201 status

    response-optional-property-removed

  • ○

    added the optional property factoryCredits to the response with the 201 status

    response-optional-property-added

• Aug 19, 202646e6b43ae479○1See the full diff
  • ○

    added the new optional request property sessionSettings/systemPrompt

    new-optional-request-property

• Aug 18, 2026613cb60e57ba○2See the full diff
  • ○

    added the new optional request property sessionSettings/worktree/parentWorktreePath

    new-optional-request-property

  • ○

    added the optional property sessionSettings/worktree/parentWorktreePath to the response with the 201 status

    response-optional-property-added

• Aug 15, 2026b742f55c9840●2○4See the full diff
  • ●

    added the new gemini-3.7-flash enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-transcribe enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new optional request property sessionSettings/worktree

    new-optional-request-property

  • ○

    added the new gemini-3.7-flash enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-transcribe enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the optional property sessionSettings/worktree to the response with the 201 status

    response-optional-property-added

• Aug 13, 202636e0c5cc926b●1○1See the full diff
  • ●

    added the new grok-4.6 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new grok-4.6 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  This revision also has 10 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Aug 12, 20265ee8657e0932●1○7See the full diff
  • ●

    added the new gpt-5.4-mini-fast enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new optional request property sessionSettings/allowSubagentsInScripts

    new-optional-request-property

  • ○

    added the new optional request property sessionSettings/toolExecutionMode

    new-optional-request-property

  • ○

    added the new gpt-5.4-mini-fast enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the non-success response with the status 503

    response-non-success-status-added

  • ○

    added the non-success response with the status 504

    response-non-success-status-added

  • ○

    added the optional property sessionSettings/allowSubagentsInScripts to the response with the 201 status

    response-optional-property-added

  • ○

    added the optional property sessionSettings/toolExecutionMode to the response with the 201 status

    response-optional-property-added

• Aug 11, 20260effac11309f●1○1See the full diff
  • ●

    added the new mistral enum value to the sessionSettings/apiProviderLock response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new mistral enum value to the request property sessionSettings/apiProviderLock

    request-property-enum-value-added

• Aug 4, 2026b2cbc420029f●1○1See the full diff
  • ●

    added the new deepseek-v4-flash-0731 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new deepseek-v4-flash-0731 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Aug 1, 2026f31331a0620b●3○3See the full diff
  • ●

    added the new gemini-3-pro-image-preview enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gpt-image-2 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new inkling enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new gemini-3-pro-image-preview enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gpt-image-2 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new inkling enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Jul 31, 20260383294a9870●1○1See the full diff
  • ●

    added the new gpt-5.6-sol-fast enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new gpt-5.6-sol-fast enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

• Jul 26, 2026749e76236673●8○12See the full diff
  • ●

    added the new agate-07-11 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new aster-07-15 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new atlas-07-21 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new claude-opus-5 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new claude-opus-5-fast enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new garnet-07-15 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new gemini-3.6-flash enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ●

    added the new kimi-k3 enum value to the sessionSettings/compactionModel/anyOf[subschema #2] response property for the response status 201

    response-property-enum-value-added

  • ○

    added the new optional request property sessionSettings/lastCallTokenUsage

    new-optional-request-property

  • ○

    added the new optional request property sessionSettings/restrictToolIds

    new-optional-request-property

  • ○

    added the new agate-07-11 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new aster-07-15 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new atlas-07-21 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new claude-opus-5 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new claude-opus-5-fast enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new garnet-07-15 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new gemini-3.6-flash enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the new kimi-k3 enum value to the request property sessionSettings/compactionModel/anyOf[subschema #2]

    request-property-enum-value-added

  • ○

    added the optional property sessionSettings/lastCallTokenUsage to the response with the 201 status

    response-optional-property-added

  • ○

    added the optional property sessionSettings/restrictToolIds to the response with the 201 status

    response-optional-property-added