SpedySpedy Docs

Board-Mitglieder

Verwalte, wer Zugriff auf ein Board hat und welche Rollen sie haben.

Board-Mitglieder steuern, wer ein bestimmtes Board sehen und damit interagieren kann. Mitglieder können einzelne Nutzer oder Teil einer Team-Zuweisung sein.

Board-Mitglieder auflisten

GET /api/v1/boards/{boardId}/members

Query-Parameter

ParameterTypPflichtBeschreibung
userRolestringNeinNach Rolle filtern: Admin, TeamMember oder Customer

Beispiel-Response

{
  "data": [
    {
      "userId": "usr_abc123",
      "name": "Alex Smith",
      "email": "[email protected]",
      "role": "BOARD_ADMIN",
      "joinedAt": "2025-01-15T10:00:00Z"
    }
  ]
}

Board-Kunden auflisten

GET /api/v1/boards/{boardId}/members/customers

Gibt nur Mitglieder mit der Kunden-Rolle zurück. Nützlich zum Filtern externer Mitarbeiter.

Board-Mitglied hinzufügen

POST /api/v1/boards/{boardId}/members

Request Body

FeldTypPflichtBeschreibung
userIdstringJaHinzuzufügende Nutzer-ID
rolestringNeinBoard-Rolle: BOARD_ADMIN, BOARD_MEMBER oder BOARD_VIEWER

Beispiel-Request

{
  "userId": "usr_abc123",
  "role": "BOARD_MEMBER"
}

Board-Mitglied abrufen

GET /api/v1/boards/{boardId}/members/{userId}

Gibt Details zu einem bestimmten Board-Mitglied zurück.

Board-Mitglied entfernen

DELETE /api/v1/boards/{boardId}/members/{userId}

Entfernt einen Nutzer vom Board. Gibt 204 No Content zurück.