---
title: "List workspaces: GET /workspaces | Posty Docs"
description: "The workspaces the key can reach. `current` marks the one the request arrived on. If the key covers several workspaces, the other routes expect the workspace id in the `showorg` header."
canonical: https://posty.hu/en/docs/api/endpoints/workspaces
source: https://posty.hu/en/docs/api/endpoints/workspaces.md
---

Basics

# List workspaces: GET /workspaces

The workspaces the key can reach. \`current\` marks the one the request arrived on. If the key covers several workspaces, the other routes expect the workspace id in the \`showorg\` header.

## Path

Method and path

GEThttps://api.posty.hu/public/v1/workspaces

Authorization

No scope required.

operationId

`listWorkspaces`

The workspaces this credential can act on: id, name, the role the key's owner holds there, and \`current\` marking the one this request acted on.

A key can span several workspaces. Every other route then expects the chosen workspace id in the \`showorg\` header and refuses with 403 instead of guessing when it is missing. This one route works without the header, so there is somewhere to pick from. In the CLI, \`posty workspaces:list\` and \`posty workspaces:use <id>\` do the same.

## Request

```
curl https://api.posty.hu/public/v1/workspaces \
  -H "Authorization: psty_your_key"
```

Copy Code

## Response

Example response structure. The [OpenAPI document](https://posty.hu/openapi.json) contains the authoritative schema for each field.

```
[
  { "id": "org_1a2b3c", "name": "Corner Coffee Ltd.", "role": "SUPERADMIN", "current": true },
  { "id": "org_4d5e6f", "name": "Personal", "role": "ADMIN", "current": false }
]
```

Copy Code

## Related

- [Authentication](https://posty.hu/en/docs/api/authentication): API key and scopes.
- [Errors and limits](https://posty.hu/en/docs/api/errors): error responses and rate limits.
- [All endpoints](https://posty.hu/en/docs/api/endpoints): full list.

Documentation pages

Is something missing from this page? Email [norbert@posty.hu](mailto:norbert@posty.hu) or use the form on the [Help](https://posty.hu/en/help) page.