Referencia de API

Usuarios

Gestiona usuarios en tu proyecto. Todos los endpoints requieren una clave secreta y son solo del lado del servidor.

Solo del lado del servidor

Todos los endpoints de gestión de usuarios requieren tu sk_live_ clave secreta. Nunca la expongas en código del lado del cliente.

GET/v1/dashboard/users

Listar usuarios

Lista todos los usuarios del proyecto actual. Requiere clave secreta.

Parámetros de consulta

text

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

Respuesta

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

Obtener usuario

Obtén un usuario por ID con sus proveedores vinculados y sesiones activas.

Respuesta

json

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

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

Bloquear usuario

Bloquea a un usuario. Revoca todas las sesiones activas e impide futuros inicios de sesión.

Respuesta

json

{ "success": true }

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

Desbloquear usuario

Levanta el bloqueo de un usuario, permitiéndole iniciar sesión de nuevo.

Respuesta

json

{ "success": true }

DELETE/v1/dashboard/users/:userId

Eliminar usuario

Elimina permanentemente a un usuario y todos sus datos. Esta acción es irreversible.

Respuesta

json

{ "success": true }