---
title: "Switch Workspace"
method: POST
path: "/api/me/workspace/{tenant_id}"
tags: ["session"]
---

# Switch Workspace

`POST /api/me/workspace/{tenant_id}`

## Request

- Base URL: `https://api.heymetra.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.heymetra.com/api/me/workspace/{tenant_id}`
- Auth: none declared

Act for a different workspace from now on.

404 rather than 403 when the caller has no membership there: a
workspace they cannot reach and one that does not exist should be
indistinguishable, or the endpoint answers "that workspace exists" to
anyone who guesses an id.

## Path parameters

- `tenant_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x-workspace-id` string, nullable

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/heymetra/apis/heymetra-api.md) · [All operations](https://skmtc.dev/heymetra/apis/heymetra-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heymetra/apis/heymetra-api/revisions/877b0f87d6d0?raw)