---
title: "Arbeitsbereiche auflisten: GET /workspaces | Posty Dokumentation"
description: "Die Arbeitsbereiche, die der Schlüssel erreicht. `current` markiert den, auf dem die Anfrage ankam. Gilt der Schlüssel für mehrere Arbeitsbereiche, erwarten die übrigen Routen die Arbeitsbereich-ID im Header `showorg`."
canonical: https://posty.hu/de/dokumentation/api/endpunkte/arbeitsbereiche
source: https://posty.hu/de/dokumentation/api/endpunkte/arbeitsbereiche.md
---

Grundlagen

# Arbeitsbereiche auflisten: GET /workspaces

Die Arbeitsbereiche, die der Schlüssel erreicht. \`current\` markiert den, auf dem die Anfrage ankam. Gilt der Schlüssel für mehrere Arbeitsbereiche, erwarten die übrigen Routen die Arbeitsbereich-ID im Header \`showorg\`.

## Der Pfad

Methode und Pfad

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

Berechtigung

Braucht keinen Scope.

operationId

`listWorkspaces`

Die Arbeitsbereiche, die dieser Zugang erreicht: ID, Name, die Rolle des Schlüsselinhabers dort, und \`current\` markiert den, auf den diese Anfrage ging.

Ein Schlüssel kann mehrere Arbeitsbereiche umfassen. Jede andere Route erwartet dann die ID des gewählten Arbeitsbereichs im Header \`showorg\` und antwortet ohne ihn mit 403, statt zu raten. Diese eine Route funktioniert auch ohne Header, damit es etwas zum Auswählen gibt. In der Befehlszeile tun \`posty workspaces:list\` und \`posty workspaces:use <id>\` dasselbe.

## Anfrage

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

Code kopieren

## Antwort

Beispiel für die Form der Antwort. Das verbindliche Schema, Feld für Feld, steht im [OpenAPI-Dokument](https://posty.hu/openapi.json).

```
[
  { "id": "org_1a2b3c", "name": "Café Sonne GmbH", "role": "SUPERADMIN", "current": true },
  { "id": "org_4d5e6f", "name": "Personal", "role": "ADMIN", "current": false }
]
```

Code kopieren

## Siehe auch

- [Authentifizierung](https://posty.hu/de/dokumentation/api/authentifizierung): der Schlüssel und die Scopes.
- [Fehler und Limits](https://posty.hu/de/dokumentation/api/fehler): die Fehlerantworten und das Aufruflimit.
- [Alle Endpunkte](https://posty.hu/de/dokumentation/api/endpunkte): die vollständige Liste.

Dokumentationsseiten

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [norbert@posty.hu](mailto:norbert@posty.hu) oder nutze auf der [Hilfeseite](https://posty.hu/de/hilfe) das Formular.