Sign in
v1
Messages

Update Session

Update session properties (e.g., title, metadata).

**Authentication Required**: Bearer token, API key, or session token

**Updatable Fields**:
- `title`: Update the conversation title
- `metadata`: Update session metadata (merged with existing)

**Example Request**:
```json
{
    "title": "Updated Session Title",
    "metadata": {"custom_field": "value"}
}
```
patch/v1/messages/sessions/{session_id}

Path parameters

session_idstring required

Request body

titlestring nullable

New title for the session

metadataobject nullable

Metadata to merge with existing session metadata

Response

Session updated successfully

object required

Generic JSON response object

Changes

Changed in 5 of the 37 revisions of this API.33

  • f29d29d1ad161See the full diff
    • ▲

      the response's body type/format changed from / to object/ for status 200

      response-body-type-changed

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

  • 22d84aa060d61See the full diff
    • ▲

      the response's body type/format changed from object/ to / for status 200

      response-body-type-changed

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

  • 02daa1da4e821See the full diff
    • ▲

      the response's body type/format changed from / to object/ for status 200

      response-body-type-changed

  • 0e4854909d2a2See the full diff
    • ○

      added the optional property detail/items/ctx to the response with the 422 status

      response-optional-property-added

    • ○

      added the optional property detail/items/input to the response with the 422 status

      response-optional-property-added

  • b0857910e8161See the full diff
    • ○

      endpoint added

      endpoint-added