Usuarios y accesos

Los usuarios de tu organización y, para cada obra o presupuesto, quién lo ve y por qué. Útil para dar los mismos accesos en tu CRM o tu gestor documental.

Son datos personales (nombre y email): necesitan el permiso read:users, que no viene marcado por defecto al crear la key.

Listar usuarios

GET/api/v1/usersread:users

Todos los de la organización, por nombre. Sin paginación.

Parámetros (query)

Parámetro	Tipo	Descripción
active boolean	boolean	true: solo los activos (los desactivados no pueden entrar en la app).

curl "https://app.buildnexion.com/api/v1/users?active=true" \
  -H "Authorization: Bearer $BUILDNEXION_API_KEY"

Respuesta

{
  "data": [
    {
      "id": "3c7e9a15-8b2d-4f61-a4e0-9d5b2c8f7e16",
      "name": "Laura Gómez",
      "email": "laura@ejemplo.es",
      "role": "responsable",
      "active": true
    },
    {
      "id": "a5d2f8e3-1c9b-4e70-b6a4-0f3e7d1c9b52",
      "name": "Javier Ortega",
      "email": "javier@ejemplo.es",
      "role": "admin",
      "active": true
    }
  ]
}

Campos

Parámetro	Tipo	Descripción
id uuid	uuid	Id del usuario (el de responsible_user_id y created_by_user_id en los presupuestos).
name / email string \| null	string \| null	Nombre y email de acceso.
role string	string	admin, responsable, encargado, contable, operario o viewer (solo lectura).
active boolean	boolean	false si se ha desactivado.

Quién ve una obra

GET/api/v1/projects/{id}/membersread:users

Quién ve un presupuesto

GET/api/v1/estimates/{id}/membersread:users

Cada usuario con acceso, con access: la lista de motivos por los que lo ve.

access

Parámetro	Tipo	Descripción
member —	—	Se le ha añadido al equipo de la obra o del presupuesto.
responsible —	—	Es el responsable.
creator —	—	Creó el presupuesto (solo en presupuestos).
assignment —	—	Asignación antigua a la obra (solo en obras).
admin —	—	Es administrador: ve todas las obras y presupuestos.

curl "https://app.buildnexion.com/api/v1/projects/6f1c2a9e-3b7d-4c1e-9a52-1d0e8b7c4a21/members" \
  -H "Authorization: Bearer $BUILDNEXION_API_KEY"

Respuesta

{
  "data": [
    {
      "user_id": "a5d2f8e3-1c9b-4e70-b6a4-0f3e7d1c9b52",
      "name": "Javier Ortega",
      "email": "javier@ejemplo.es",
      "role": "admin",
      "active": true,
      "access": [
        "admin"
      ]
    },
    {
      "user_id": "3c7e9a15-8b2d-4f61-a4e0-9d5b2c8f7e16",
      "name": "Laura Gómez",
      "email": "laura@ejemplo.es",
      "role": "responsable",
      "active": true,
      "access": [
        "member",
        "responsible"
      ]
    }
  ]
}

Al cambiar el equipo de una obra o un presupuesto se emite el webhook members.updated con { entity, id }, y su updated_at se actualiza.