Consultar usuario autorizado

Lista los usuarios autorizados en la cuenta del solicitante. Los resultados siempre están limitados al ámbito de la cuenta del solicitante: los tokens Bearer usan la cuenta del token; las llamadas con Basic (clave de API) usan la cuenta del operador configurada para la aplicación. Se excluyen las asignaciones de rol para OWNER. Ambos filtros son opcionales y reducen aún más los resultados por email y/o phone. 🔒 Acceso restringido Esta consulta requiere el alcance VIEW_SUBUSERS. Admite autenticación tanto Bearer (token de acceso de usuario) como Basic (<API_KEY>).

query AuthorizedUsers(
  $email: String
  $phone: String
) {
  authorizedUsers(
    email: $email
    phone: $phone
  ) {
    authUserId
    roles
    status
    email
    phone
    firstName
    lastName
  }
}

Parámetros

Parámetro	Tipo	Requerido	Descripción
email	String	No	Filtra por la dirección de correo del usuario autorizado.
phone	String	No	Filtra por el número de teléfono del usuario autorizado.

Respuesta

Respuesta exitosa

{
  "data": {
    "authorizedUsers": [
      {
        "authUserId": "8b2c1e0a-7d4f-4a9b-9c2d-1f3e4a5b6c7d",
        "roles": ["MANAGER", "VIEWER"],
        "status": "ACTIVE",
        "email": "teammate@example.com",
        "phone": "+15555555555",
        "firstName": "Ada",
        "lastName": "Lovelace"
      }
    ]
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
`authUserId`	UUID	El ID del usuario autorizado (ID de asignación de rol UAC). Pasa este valor a `removeAuthorizedUser`.
`roles`	[UACRoleType]	Roles asignados al usuario en la cuenta.
`status`	UACRoleStatusType	Estado de la asignación de rol: `PENDING`, `ACTIVE`, `INACTIVE` o `DECLINED`.
`email`	String	Dirección de correo electrónico del usuario autorizado.
`phone`	String	Número de teléfono del usuario autorizado.
`firstName`	String	Nombre del usuario autorizado.
`lastName`	String	Apellido del usuario autorizado.

Ejemplo de solicitud

curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_access_token>" \
  -d '{
  "query": "query AuthorizedUsers($email: String, $phone: String) { authorizedUsers(email: $email, phone: $phone) { authUserId roles status email phone firstName lastName } }",
  "variables": {
    "email": "teammate@example.com"
  }
}'

const response = await fetch('https://transactional-graph.staging.fluzapp.com/api/v1/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${accessToken}`
  },
  body: JSON.stringify({
    query: `
      query AuthorizedUsers(
        $email: String
        $phone: String
      ) {
        authorizedUsers(
          email: $email
          phone: $phone
        ) {
          authUserId
          roles
          status
          email
          phone
          firstName
          lastName
        }
      }
    `,
    variables: {
      email: "teammate@example.com"
    }
  })
});

const data = await response.json();
console.log('Authorized users:', data.data.authorizedUsers);

Códigos de error

Código	Mensaje	Descripción
`AUTH-0008`	Invalid user access	No se pudo resolver el solicitante a partir del token de acceso o la clave de API, o la aplicación con autenticación Basic no tiene configurada una cuenta de operador. Verifica tus credenciales de autenticación.
`AUTH-0031`	The requested scopes must be granted by the user first.	Al token le falta el alcance `VIEW_SUBUSERS` requerido para listar usuarios autorizados.

​Parámetros

​Respuesta

​Respuesta exitosa

​Campos de la respuesta

​Ejemplo de solicitud

​Códigos de error