Skip to Content
Uptimeify Docs

Benutzer auflisten

Listet die Benutzer der Organisation auf, die der Aufrufer sehen darf.

GET /api/users

Wer sieht welche Benutzer

Die Antwort wird auf den Kundenbereich des Aufrufers eingegrenzt, also denselben Bereich, der auch /api/customers, /api/incidents und die Monitor-Endpunkte steuert. Ein Benutzer gehört nie zu einem Kunden, die Verbindung ist die Kundenzuordnung, und genau daraus ergibt sich die Sichtbarkeit:

AufruferGelieferte Benutzer
Organisations-Administrator, globaler Administrator, globaler Supporter, organisationsweites API- oder Agenten-TokenAlle Benutzer der Organisation (unverändert)
Editor ohne KundenzuordnungAlle Benutzer der Organisation
Readonly-Benutzer, Editor mit Kundenzuordnung, kundengebundenes API-Token, kundengebundenes Agenten-TokenNur Benutzer, die mindestens einem der eigenen Kunden zugeordnet sind, zuzüglich des Aufrufers selbst
Aufrufer ohne jede Kundenzuordnung (etwa die reine IM-Rolle responder)Leere Liste

Zwei Punkte gelten zusätzlich für kundengebundene Aufrufer:

  • Das Feld customerAccess jedes gelieferten Benutzers wird auf die eigenen Kunden gekürzt. Ein Kollege, der zusätzlich für andere Kunden arbeitet, verrät diese hier nicht.
  • limits wird weiterhin geliefert. Platzkontingente sind Tarifangaben auf Ebene der Organisation, und currentSeats zählt die Benutzer, die tatsächlich in der Antwort stehen.

Ein Zugriff über Organisationsgrenzen hinweg ist in keinem Fall möglich, die Organisationsgrenze greift vor dem Kundenbereich.

Antwort (Response)

{
  "users": [
    {
      "id": "A7QJr8SOjsnTst1n9YQSYxim1GeEPht7",
      "email": "max@deinkunde.com",
      "name": "Max Mustermann",
      "firstName": "Max",
      "lastName": "Mustermann",
      "image": null,
      "role": "admin",
      "language": "en",
      "isActive": true,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "customerAccess": [
        { "customerId": 42, "customerName": "Beispiel GmbH" }
      ]
    }
  ],
  "limits": {
    "maxSeats": null,
    "currentSeats": 1,
    "remainingSeats": null
  }
}

language ist die Mail-Sprache des Logins (de, en oder da); null heißt Sprache der Organisation.

Listenform: Mit envelope=items kommt die Liste als { items, total, page, perPage }, eine Seite mit allen Benutzern, die der Aufrufer sehen darf, ohne limits. Ohne den Parameter antwortet der Endpunkt noch in der bisherigen Form ({ users, limits }); sie ist veraltet, ab dem 18.01.2027 ist { items, ... } der Standard.

Häufige Fehler

Statusdata.codeBedeutung
401unauthorizedKeine gültige Sitzung, kein gültiges Token.
400organizationIdRequiredDie Sitzung trägt keine Organisation.

Auf dieser Seite