---
title: "Changes to Get Or Create Session"
method: POST
path: "/v3/workspaces/{workspace_id}/sessions"
---

# Changes to Get Or Create Session

`POST /v3/workspaces/{workspace_id}/sessions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 37 revisions.

- **2026-10-28** (v3) `4202d6324a47`: 1 info
- **2026-10-16** (v3) `c10fbe693a00`: 1 info
- **2026-10-06** (v3) `92a85ce9b1e7`: 5 info
- **2026-08-27** (v3) `63b701d883c9`: 1 info
- **2026-05-21** (v3) `fb8bc7682a0f`: 1 info
- **2026-02-26** (v3) `0730be052dc9`: 2 info

## Changes

- **2026-10-28** (v3) `4202d6324a47`: 1 info
  - added the optional property `scopes` to the response with the `200` status
- **2026-10-16** (v3) `c10fbe693a00`: 1 info
  - added the required property `uid` to the response with the `200` status
- **2026-10-06** (v3) `92a85ce9b1e7`: 5 info
  - added the new optional request property `configuration/anyOf[subschema #1: SessionConfiguration]/custom_instructions`
  - added the new optional request property `configuration/anyOf[subschema #1: SessionConfiguration]/dialectic`
  - added the new optional request property `configuration/anyOf[subschema #1: SessionConfiguration]/dream/anyOf[subschema #1: DreamConfiguration]/custom_instructions`
  - added the new optional request property `configuration/anyOf[subschema #1: SessionConfiguration]/peer_card/anyOf[subschema #1: PeerCardConfiguration]/custom_instructions`
  - added the new optional request property `configuration/anyOf[subschema #1: SessionConfiguration]/summary/anyOf[subschema #1: SummaryConfiguration]/custom_instructions`
- **2026-08-27** (v3) `63b701d883c9`: 1 info
  - added the new optional request property `scopes`
- **2026-05-21** (v3) `fb8bc7682a0f`: 1 info
  - the `id` request property's maxLength was increased from `100` to `512`
- **2026-02-26** (v3) `0730be052dc9`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

---

[Operation](https://skmtc.dev/plastic-labs/apis/honcho-api/docs/v3/workspaces/:workspace_id/sessions/post.md) - [API](https://skmtc.dev/plastic-labs/apis/honcho-api.md) - [Page](https://skmtc.dev/plastic-labs/apis/honcho-api/changes/v3/workspaces/:workspace_id/sessions/post)