---
title: "Get Or Create Workspace"
method: POST
path: "/v3/workspaces"
tags: ["workspaces"]
---

# Get Or Create Workspace

`POST /v3/workspaces`

Get a Workspace by ID.

If workspace_id is provided as a query parameter, it uses that (must match JWT workspace_id).
Otherwise, it uses the workspace_id from the JWT.

## Request body

- WorkspaceCreate
  - `id` string, required
  - `metadata` object
  - `configuration` WorkspaceConfiguration — The set of options that can be in a workspace 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

- 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)