# Get your workspace

> The workspace your API key acts on, with your plan.

**Source:** https://postprism.app/docs/api/get-workspace  
**Updated:** 2026-10-10

---

`GET https://studio.postprism.app/api/v1/workspace`

Returns the workspace your API key was created in, which is the default for every other endpoint, and your Postprism plan.

## Example

```bash
curl "https://studio.postprism.app/api/v1/workspace" \
  -H "Authorization: Bearer pp_live_your_api_key"
```

## Response

Status `200`.

`data` is a `WorkspaceInfo`: The workspace your API key acts on by default.

| Field | Type | Description |
| --- | --- | --- |
| `workspace_id` | uuid | The workspace ID. |
| `name` | string, nullable | The workspace name. |
| `plan` | string | Your Postprism plan. One of: `solo`, `freelancer`, `agency`. |

```json
{
  "data": {
    "workspace_id": "7b2d4e6f-0000-4000-8000-00000000b001",
    "name": "Juniper Roasters",
    "plan": "freelancer"
  },
  "error": null
}
```

## Errors

| Status | Message | When |
| --- | --- | --- |
| 401 | `Invalid or revoked API key` | The `Authorization` header is missing, malformed, or the key was revoked. |
| 429 | `Too many requests` | You went over the hourly limit. See Rate limits. |