Munkaterületek listázása: 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.

Az útvonal

A kulcs által elérhető munkaterületek adatai: azonosító, név és a kulcs tulajdonosának szerepe. A `current` azt jelöli, amelyikre ez a kérés érkezett.

Egy kulcs több munkaterületre is szólhat. Ilyenkor minden más útvonal a `showorg` fejlécben várja a kiválasztott munkaterület azonosítóját. Ha a fejléc hiányzik, 403-mal válaszol. Ez az útvonal fejléc nélkül is működik, így lekérheted a választható munkaterületeket. A parancssorban erre a `posty workspaces:list` és a `posty workspaces:use <id>` parancs szolgál.

Kérés

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

Válasz

Példa a válasz alakjára. A mezőnkénti, kötelező érvényű sémát az OpenAPI dokumentum tartalmazza.

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

Kapcsolódó

• Hitelesítés: a kulcs és a scope-ok.
• Hibák és korlátok: a hibaválaszok és a hívási keret.
• Minden végpont: a teljes lista.