Board Permissions
4 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1
List all permissions for a board with user details#
GET
/boards/{boardId}/permissionsTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
boardIdPflicht | Pfad | string | – |
Antworten
- 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/permissions" \
-H "Authorization: Bearer $XISUITE_TOKEN"Grant a permission to a user on a board#
POST
/boards/{boardId}/permissionsTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
boardIdPflicht | Pfad | string | – |
Request-Body
| Name | Typ | Beschreibung |
|---|---|---|
board_id | string (uuid) | Legacy board UUID echo from Next clients (ignored; path param is authoritative) |
user_idPflicht | string (uuid) | – |
permission_level | string | Werte: |
Antworten
- 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/permissions" \
-H "Authorization: Bearer $XISUITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"user_id":"…"}'Update the permission level for a board permission#
PATCH
/boards/{boardId}/permissions/{permissionId}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
boardIdPflicht | Pfad | string | – |
permissionIdPflicht | Pfad | string | – |
Request-Body
| Name | Typ | Beschreibung |
|---|---|---|
permission_levelPflicht | string | Werte: |
Antworten
- 200OK
Beispiel (cURL)
curl -X PATCH "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/permissions/{permissionId}" \
-H "Authorization: Bearer $XISUITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"permission_level":"view"}'Revoke a board permission#
DELETE
/boards/{boardId}/permissions/{permissionId}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
boardIdPflicht | Pfad | string | – |
permissionIdPflicht | Pfad | string | – |
Antworten
- 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/permissions/{permissionId}" \
-H "Authorization: Bearer $XISUITE_TOKEN"