---
title: "List workspaces: GET /workspaces | Posty dokumentáció"
description: "A kulcs által elérhető munkaterületek. A `current` azt jelöli, amelyikre a kérés érkezett. Ha a kulcs több munkaterületre szól, a többi útvonal a `showorg` fejlécben várja a munkaterület azonosítóját."
canonical: https://posty.hu/en/docs/api/endpoints/munkateruletek
source: https://posty.hu/en/docs/api/endpoints/munkateruletek.md
---

Basics

# List workspaces: GET /workspaces

A kulcs által elérhető munkaterületek. A \`current\` azt jelöli, amelyikre a kérés érkezett. Ha a kulcs több munkaterületre szól, a többi útvonal a \`showorg\` fejlécben várja a munkaterület azonosítóját.

## 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_a_kulcsod"
```

Kód másolása

## Response

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

```
[
  { "id": "org_1a2b3c", "name": "Kávézó Kft.", "role": "SUPERADMIN", "current": true },
  { "id": "org_4d5e6f", "name": "Personal", "role": "ADMIN", "current": false }
]
```

Kód másolása

## 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.