API-Referenz

Benutzer

Benutzer in Ihrem Projekt verwalten. Alle Endpunkte erfordern einen geheimen Schlüssel und sind nur serverseitig.

Nur serverseitig

Alle Benutzerverwaltungs-Endpunkte erfordern Ihren sk_live_ geheimen Schlüssel. Stellen Sie diesen niemals in clientseitigem Code bereit.

GET/v1/dashboard/users

Benutzer auflisten

Listet alle Benutzer im aktuellen Projekt auf. Erfordert einen geheimen Schlüssel.

Query-Parameter

text

?limit=20&offset=0&search=john&projectId=proj_abc123

Antwort

json

{
  "users": [
    {
      "id": "usr_abc123",
      "email": "user@example.com",
      "displayName": "John Doe",
      "avatarUrl": null,
      "isBanned": false,
      "signInCount": 5,
      "lastSignInAt": "2026-01-15T10:30:00Z",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "total": 42
}

GET/v1/dashboard/users/:userId

Benutzer abrufen

Ruft einen einzelnen Benutzer nach ID mit seinen verknüpften Anbietern und aktiven Sitzungen ab.

Antwort

json

{
  "id": "usr_abc123",
  "email": "user@example.com",
  "displayName": "John Doe",
  "providers": ["google", "github"],
  "sessions": [...],
  "publicMetadata": {}
}

PATCH/v1/dashboard/users/:userId/ban

Benutzer sperren

Sperrt einen Benutzer. Widerruft alle aktiven Sitzungen und verhindert zukünftige Anmeldungen.

Antwort

json

{ "success": true }

PATCH/v1/dashboard/users/:userId/unban

Sperre aufheben

Hebt die Sperre eines Benutzers auf und ermöglicht ihm, sich erneut anzumelden.

Antwort

json

{ "success": true }

DELETE/v1/dashboard/users/:userId

Benutzer löschen

Löscht einen Benutzer und alle seine Daten dauerhaft. Diese Aktion ist unwiderruflich.

Antwort

json

{ "success": true }