Kunden-Token erstellen

POST /api/customer/tokens

Anfrage (Request Body)Ankerlink kopieren

Beispiel (cURL)Ankerlink kopieren

curl -X POST "$BASE_URL/api/customer/tokens" \
  -H "Cookie: $SESSION_COOKIE" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp API Token",
    "customerId": 5,
    "expiresInDays": 180
  }'

Antwort (Response)Ankerlink kopieren

{
  "id": 2,
  "name": "Acme Corp API Token",
  "token": "wsm_f7e6d5c4b3a2...",
  "lastUsedAt": null,
  "expiresAt": "2026-10-15T08:00:00.000Z",
  "createdAt": "2026-04-15T08:00:00.000Z"
}

Häufige FehlerAnkerlink kopieren

• 400 Invalid customer ID wenn die customerId nicht zu deiner Organisation gehört
• 400 customerId is required wenn ein eingeschränkter Nutzer keine customerId angibt
• 403 Forbidden wenn der Kunde außerhalb des Gültigkeitsbereichs des Nutzers liegt

BerechtigungenAnkerlink kopieren

Offen für Organisations-Admins und für die Rolle readonly; editor und responder werden mit insufficientPermissions abgewiesen. Ein Nur-Lese-Zugang ist immer kundengebunden, customerId ist für ihn deshalb Pflicht und muss einen seiner eigenen Kunden benennen. Ein organisationsweiter Token (ohne customerId) ist für diese Rolle nicht erreichbar.

Der ausgestellte Token erbt die Rolle seines Erstellers. Ein von einem Nur-Lese-Zugang erzeugter Token kann damit nicht mehr als dieser Zugang: Er löscht keine Monitore und ändert keine Besitzklasse.