Skip to Content
Uptimeify Docs

Kunden-Tokens auflisten

Gibt die für den aktuellen Nutzer sichtbaren API-Tokens zurück. Eingeschränkte Nutzer sehen nur ihre kundenbezogenen Tokens; Admins sehen alle Tokens. Tokens sind maskiert: nur die ersten 8 Zeichen werden angezeigt.

GET /api/customer/tokens

Query-Parameter

ParameterTypStandardBeschreibung
envelopestringkeineritems: Antwort als { items, total, page, perPage }. Ab 18.01.2027 Standard.

Beispiel (cURL)

curl -X GET "$BASE_URL/api/customer/tokens?envelope=items" \
  -H "Cookie: $SESSION_COOKIE" \
  -H "Accept: application/json"

Antwort (Response)

{
  "items": [
    {
      "id": 2,
      "organizationId": 1,
      "name": "Customer Scoped Token",
      "customerId": 5,
      "customerName": "Acme Corp",
      "lastUsedAt": null,
      "expiresAt": null,
      "createdAt": "2026-02-01T08:00:00.000Z",
      "tokenHint": "wsm_f7e6d5..."
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 1
}

Listenform: Mit envelope=items kommt die Liste als { items, total, page, perPage }. Ohne den Parameter antwortet der Endpunkt noch in der bisherigen Form (ein blankes Array derselben Einträge); sie ist veraltet, ab dem 18.01.2027 ist { items, ... } der Standard.

Häufige Fehler

  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden wenn der Nutzer keinen Lesezugriff hat

Auf dieser Seite