Usuarios

Miembros del equipo en tu espacio de trabajo — sus roles, estado y asignaciones de nodos del organigrama. Los hashes de contraseña, secretos TOTP y datos de sesión nunca se devuelven.

GET/api/v1/users

Lista paginada de usuarios en tu organización.

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
limit	integer	opcional	Número de resultados (predeterminado 100, máximo 500).
cursor	ISO 8601	opcional	Cursor de paginación de nextCursor.
role	string	opcional	Filtrar por rol: admin \| editor \| viewer
status	string	opcional	Filtrar por estado: pending \| active \| rejected \| suspended

Valores desconocidos de role o status devuelven 400 Bad Request con un array allowed que lista los valores aceptados.

Ejemplo de respuesta

Json

{
  "data": [
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "name": "Alice Johnson",
      "email": "alice@acme.com",
      "role": "admin",
      "status": "active",
      "assignedNodeId": "550e8400-e29b-41d4-a716-446655440000",
      "emailVerifiedAt": "2025-03-01T13:00:00.000Z",
      "createdAt": "2025-03-01T12:30:00.000Z"
    },
    {
      "id": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
      "name": "Bob Smith",
      "email": "bob@acme.com",
      "role": "editor",
      "status": "active",
      "assignedNodeId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "emailVerifiedAt": "2025-03-02T09:00:00.000Z",
      "createdAt": "2025-03-02T08:45:00.000Z"
    }
  ],
  "nextCursor": null
}

Objeto usuario

Campos

Nombre	Tipo	Obligatorio	Descripción
id	uuid	opcional	ID único del usuario.
name	string	opcional	Nombre mostrado.
email	string	opcional	Dirección de correo.
role	string	opcional	admin \| editor \| viewer
status	string	opcional	pending \| active \| rejected \| suspended
assignedNodeId	uuid \| null	opcional	El nodo del organigrama al que está anclado este usuario.
emailVerifiedAt	ISO 8601 \| null	opcional	Cuándo el usuario verificó su correo. null = no verificado.
createdAt	ISO 8601	opcional	Cuándo se creó el usuario.

Campos nunca devueltos: passwordHash, totpSecret, notificationPrefs.

Ejemplos de código

# Todos los usuarios
curl "https://sopflow.io/api/v1/users" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

# Solo administradores activos
curl "https://sopflow.io/api/v1/users?role=admin&status=active" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Administración de usuarios

Las claves API no pueden cambiar roles, estados ni nodos asignados. Un administrador con sesión iniciada debe realizar estos cambios en la interfaz de administración. El endpoint anterior PATCH /api/v1/users/:id está deshabilitado para claves API y devuelve 403 con el código human_admin_required para una clave de escritura válida.

Usuarios

Objeto usuario

Ejemplos de código

Administración de usuarios

Conciliar usuarios sin suponer permisos