---
title: "Retrieve a workspace"
method: GET
path: "/v2/workspaces/{key}"
tags: ["Workspaces"]
---

# Retrieve a workspace

`GET /v2/workspaces/{key}`

Retrieves a workspace by its key. A user session must be a member and does not need a workspace-scoped token. A management key may only retrieve the workspace bound to the key.

## Path parameters

- `key` string, required

## Response `200`

OK

- GetWorkspaceResponse
  - `workspace` Workspace, required
    - `id` string, required
    - `key` string, required
    - `display_name` string, required
    - `logo_url` string
    - `archived_on` string, date-time
    - `archived_by_id` string
    - `organization` WorkspaceOrganization
      - `id` string
      - `key` string
    - `settings` WorkspaceSettingsFields
      - `same_project_entities_enabled` boolean
      - `model_garden_settings` object
      - `plugins` object
    - `sidebar_version` string
    - `features` object
    - `total_members` integer
    - `metadata` object
    - `capabilities` WorkspaceCapabilities
      - `roles` string[]
      - `projects` string[]

## Changes

> 350 revisions in range; 136 not diffed.

- **2026-09-07** `bcd6172f8655` — 1 info
  - endpoint added
- **2026-09-07** `dcc0afb98a48` — 1 breaking
  - api path removed without deprecation
- **2026-09-06** `e1a2869bc12f` — 1 info
  - endpoint added
- **2026-09-06** `28c58af69b8c` — 1 breaking
  - api path removed without deprecation
- **2026-09-04** `bd22332086ec` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/workspaces/:key/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/3c7d859558ee?raw)