---
title: "Switch current workspace"
method: POST
path: "/workspaces/{reference}"
tags: ["workspace"]
---

# Switch current workspace

`POST /workspaces/{reference}`

## Path parameters

- `reference` string, required

## Response `200`

OK

- ServerFetchWorkspaceResponse
  - `message` string, required
  - `workspace` MalakWorkspace, required
    - `created_at` string
    - `id` string
    - `metadata` MalakPlanMetadata
      - `deck` object
        - `count` integer
      - `team` object
        - `enabled` boolean
        - `size` integer
    - `plan_id` string
    - `reference` string
    - `stripe_customer_id` string — Not required Dummy values work really
    - `subscription_id` string
    - `updated_at` string
    - `workspace_name` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2024-12-24** `60bec59f1e00` — 1 info
  - added the optional property `workspace/metadata/deck` to the response with the `200` status
- **2024-11-14** `9eeda9b06388` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ayinke-llc/apis/malak-s-api-documentation/changes/workspaces/:reference/post.md)

---

[API](https://skmtc.dev/ayinke-llc/apis/malak-s-api-documentation.md) · [All operations](https://skmtc.dev/ayinke-llc/apis/malak-s-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ayinke-llc/malak-s-api-documentation/revisions/ab3daa8a3323/schema)