---
title: "Get Workspace"
method: GET
path: "/api/v1/workspaces/{workspace_id}"
tags: ["workspaces"]
---

# Get Workspace

`GET /api/v1/workspaces/{workspace_id}`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v1/workspaces/{workspace_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-Organization-Id`
  - HTTP bearer

Get a single workspace by ID, scoped to the current org and identity.

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `include_deleted` boolean: Also return the workspace if it has been deleted.
- `data_plane_id` string, uuid, nullable: Accepted only from a data plane service; other callers get 403.

## Response `200`

Successful Response

- TenantForUser
  - `id` string, uuid, required
  - `organization_id` string, uuid, nullable
  - `created_at` string, date-time, required
  - `display_name` string, required
  - `is_personal` boolean, required
  - `is_deleted` boolean, required
  - `tenant_handle` string, nullable
  - `data_plane_url` string, nullable
  - `read_only` boolean
  - `role_id` string, uuid, nullable
  - `role_name` string, nullable
  - `permissions` string[], nullable

## Other responses

- `403`: data_plane_id was sent by a caller other than that data plane's service.
- `422`: Validation Error

## Changes

- **2026-10-28** `73dfb1001b4b`: 1 info
  - added the non-success response with the status `403`
- **2026-10-16** `1a8ee9358d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/workspaces/:workspace_id/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)