REST APIGET

Członkowie

Wyświetl członków obszaru roboczego i usuń kogoś z obszaru roboczego lub z całej organizacji.

GEThttps://post.adaptlypost.com/post/api/v1/members

Zwraca członków obszaru roboczego, w którym działa wywołanie, wraz z ich rolą w nim i rolami w organizacji.

Klucz API (token Bearer)
Uprawnienie:members.readRole i uprawnienia

Pola odpowiedzi

PoleOpis
userIdID użytkownika członka. Służy do usunięcia członka.
emailAdres e-mail członka.
firstNameImię lub null.
lastNameNazwisko lub null.
roleRola w tym obszarze roboczym: admin, editor, contributor lub viewer.
organizationRolesRole w organizacji, np. org-owner, org-admin lub org-member.
joinedAtKiedy członek dołączył do obszaru roboczego.

Usuń członka z tego obszaru roboczego

DELETEhttps://post.adaptlypost.com/post/api/v1/members/:userId

Usuwa członka z obszaru roboczego, w którym działa wywołanie, i unieważnia jego klucze API oraz linki do połączenia w tym obszarze. Członek pozostaje w organizacji i zachowuje pozostałe obszary robocze.

Klucz API (token Bearer)
Uprawnienie:members.manageRole i uprawnienia

Klucz nie może usunąć członka, który go utworzył, ani odebrać członkowi ostatniego obszaru roboczego. Oba przypadki zwracają 400. Aby odebrać komuś ostatni obszar roboczy, należy usunąć tę osobę z organizacji. Użytkownik, który nie jest członkiem tego obszaru roboczego, zwraca 404.

Usuń członka z organizacji

DELETEhttps://post.adaptlypost.com/post/api/v1/organization/members/:userId

Usuwa członka z organizacji i ze wszystkich jej obszarów roboczych oraz unieważnia wszystkie jego klucze API i linki do połączenia.

Klucz API (token Bearer)
Uprawnienie:members.manageRole i uprawnienia

W chwili wywołania twórca klucza musi być też właścicielem lub administratorem organizacji. W przeciwnym razie wywołanie zwraca 403 permission_denied.

Nie można usunąć właściciela organizacji, a administratora organizacji może usunąć tylko właściciel. Klucz nie może usunąć członka, który go utworzył; taka próba zwraca 400. Użytkownik spoza organizacji zwraca 404.

Oba wywołania zwracają 200 z { "success": true }.

Wskazówka dla agentów: najpierw należy powiedzieć użytkownikowi, kto zostanie usunięty i skąd, i uzyskać jego zgodę. Usunięcie unieważnia też klucze API tej osoby, więc integracja, która korzysta z któregoś z nich, przestanie działać.

Odmowy

403 z kodem permission_denied oznacza, że rola klucza nie ma tego uprawnienia albo twórca klucza nie jest właścicielem ani administratorem organizacji tam, gdzie wywołanie tego wymaga. Odpowiedź jest ostateczna, więc nie należy ponawiać. Należy poprosić użytkownika, by zmianę wprowadził administrator organizacji.

403 z kodem subscription_required oznacza, że plan nie jest aktywny lub osiągnął limit: brak miejsca na kolejny obszar roboczy albo brak wolnego miejsca w zespole na zaproszenie. Treść zawiera też errorCode, limitKey, limit i currentUsage. Należy poprosić użytkownika o podniesienie planu i nie ponawiać.

403 Forbidden: osiągnięto limit planu
{
  "statusCode": 403,
  "error": "Forbidden",
  "code": "subscription_required",
  "errorCode": "LIMIT_EXCEEDED",
  "limitKey": "max_workspaces",
  "limit": 3,
  "currentUsage": 3,
  "message": "..."
}

Kod 429 oznacza przekroczenie limitu żądań. Przed kolejnym wywołaniem należy odczekać czas podany w Retry-After.

Lista członków
curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/members \
  --header 'Authorization: Bearer <api-key>'
Usunięcie z tego obszaru roboczego
curl --request DELETE \
  --url https://post.adaptlypost.com/post/api/v1/members/user_05m8p \
  --header 'Authorization: Bearer <api-key>'
Usunięcie z organizacji
curl --request DELETE \
  --url https://post.adaptlypost.com/post/api/v1/organization/members/user_05m8p \
  --header 'Authorization: Bearer <api-key>'
200
{
  "members": [
    {
      "userId": "user_01j2k",
      "email": "ana@example.com",
      "firstName": "Ana",
      "lastName": "Silva",
      "role": "admin",
      "organizationRoles": ["org-owner"],
      "joinedAt": "2026-03-02T09:15:00.000Z"
    },
    {
      "userId": "user_05m8p",
      "email": "tom@example.com",
      "firstName": "Tom",
      "lastName": null,
      "role": "contributor",
      "organizationRoles": ["org-member"],
      "joinedAt": "2026-10-20T14:40:00.000Z"
    }
  ]
}