---
title: "Get current workspace"
method: GET
path: "/workspace"
tags: ["Workspace"]
---

# Get current workspace

`GET /workspace`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/workspace`
- Auth: API key in header `X-Api-Key`

Returns information about the workspace this request resolved to: name, plan, credit balance, member count and the role of the user who created the key.

A key bound to one workspace always resolves to it. A key bound to several resolves to the one in the `X-Workspace-Id` header, so call this whenever you need to confirm which workspace a request is actually hitting.

## Response `200`

Response for status 200

- object
  - `id` string, required: Unique workspace ID
  - `name` string, required: Workspace name
  - `is_personal` boolean, required: `true` if this is the user's personal workspace, `false` if it is a team workspace
  - `status` string, required: Workspace status — typically `active`
  - `role` 'admin' | 'member', required
  - `plan_id` string, required: ID of the current subscription plan
  - `plan_name` string, nullable, required: Display name of the current plan
  - `plan_is_free` boolean, required: `true` if the workspace is on the free plan
  - `credits` number, required: Current credit balance for this workspace
  - `credits_unlimited` boolean, required: `true` while usage is free for this workspace: jobs run without consuming the balance
  - `credits_unlimited_until` string, nullable, required: ISO 8601 timestamp when the free-usage window ends; `null` means it has no end date
  - `seat_count` number, required: Extra purchased seats. Legacy: always 0 today, seats come with the plan
  - `max_total_seats` number, required: Maximum total seats available on the current plan, including any plan-included free seats
  - `member_count` number, required: Total members currently in the workspace, including the owner
  - `created_at` string, required: ISO 8601 timestamp of when the workspace was created

## Other responses

- `404`: Response for status 404

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)