---
title: "Update Session"
method: PUT
path: "/v3/workspaces/{workspace_id}/sessions/{session_id}"
tags: ["sessions"]
---

# Update Session

`PUT /v3/workspaces/{workspace_id}/sessions/{session_id}`

Update a Session's metadata and/or configuration.

## Path parameters

- `workspace_id` string, required
- `session_id` string, required

## Request body

- SessionUpdate
  - `metadata` object, nullable
  - `configuration` SessionConfiguration — The set of options that can be in a session DB-level configuration dictionary. All fields are optional. Session-level configuration overrides workspace-level configuration, which overrides global configuration.
    - `reasoning` ReasoningConfiguration
      - `enabled` boolean, nullable — Whether to enable reasoning functionality.
      - `custom_instructions` string, nullable — TODO: currently unused. Custom instructions to use for the reasoning system on this workspace/session/message.
    - `peer_card` PeerCardConfiguration
      - `use` boolean, nullable — Whether to use peer card related to this peer during reasoning process.
      - `create` boolean, nullable — Whether to generate peer card based on content.
    - `summary` SummaryConfiguration
      - `enabled` boolean, nullable — Whether to enable summary functionality.
      - `messages_per_short_summary` integer, nullable — Number of messages per short summary. Must be positive, greater than or equal to 10, and less than messages_per_long_summary.
      - `messages_per_long_summary` integer, nullable — Number of messages per long summary. Must be positive, greater than or equal to 20, and greater than messages_per_short_summary.
    - `dream` DreamConfiguration
      - `enabled` boolean, nullable — Whether to enable dream functionality. If reasoning is disabled, dreams will also be disabled and this setting will be ignored.

## Response `200`

Successful Response

- Session
  - `id` string, required
  - `is_active` boolean, required
  - `workspace_id` string, required
  - `metadata` object
  - `configuration` object
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/clawdsolana/apis/honcho-api.md) · [All operations](https://skmtc.net/clawdsolana/apis/honcho-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clawdsolana/honcho-api/versions/0730be052dc9/schema)