Eliminar usuario autorizado

Elimina un usuario autorizado de la cuenta del solicitante desactivando su asignación de rol. Esta mutación no elimina al usuario: establece la asignación de rol en la cuenta del solicitante como INACTIVE, revocando su acceso. El propietario de la cuenta (rol OWNER) no puede ser eliminado mediante este endpoint. La cuenta de destino siempre se resuelve a partir de las credenciales del solicitante: los tokens Bearer usan la cuenta del token; las llamadas Básicas (clave de API) usan la cuenta de operador configurada de la aplicación. El authUserId debe referirse a una asignación de rol en esa cuenta; de lo contrario, la solicitud será rechazada. 🔒 Acceso restringido Esta mutación requiere el scope MANAGE_SUBUSERS. Admite autenticación tanto Bearer (token de acceso de usuario) como Basic (<API_KEY>).

mutation RemoveAuthorizedUser(
  $authUserId: UUID!
) {
  removeAuthorizedUser(
    authUserId: $authUserId
  ) {
    success
    authUserId
    status
    error {
      code
      message
    }
  }
}

Parámetros

Parámetro	Tipo	Requerido	Descripción
authUserId	UUID	Sí	El ID del usuario autorizado (ID de asignación de rol UAC) a desactivar. Obtén esto de `authorizedUsers` o `addAuthorizedUser`.

Respuesta

Respuesta exitosa

{
  "data": {
    "removeAuthorizedUser": {
      "success": true,
      "authUserId": "8b2c1e0a-7d4f-4a9b-9c2d-1f3e4a5b6c7d",
      "status": "INACTIVE",
      "error": null
    }
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
`success`	Boolean	`true` si la asignación de rol se desactivó correctamente.
`authUserId`	UUID	El ID del usuario autorizado (ID de asignación de rol UAC) que se actualizó.
`status`	UACRoleStatusType	Estado actualizado de la asignación de rol. Será `INACTIVE` en caso de éxito.
`error`	AuthorizedUserError	Si `success` es false, un objeto de error que contiene `code` y `message`.

Esta mutación devuelve errores en los datos de la respuesta, no como errores de GraphQL. Verifica siempre el campo success y maneja el objeto error cuando success sea false.

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": "mutation RemoveAuthorizedUser($authUserId: UUID!) { removeAuthorizedUser(authUserId: $authUserId) { success authUserId status error { code message } } }",
  "variables": {
    "authUserId": "8b2c1e0a-7d4f-4a9b-9c2d-1f3e4a5b6c7d"
  }
}'

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: `
      mutation RemoveAuthorizedUser(
        $authUserId: UUID!
      ) {
        removeAuthorizedUser(
          authUserId: $authUserId
        ) {
          success
          authUserId
          status
          error {
            code
            message
          }
        }
      }
    `,
    variables: {
      authUserId: "8b2c1e0a-7d4f-4a9b-9c2d-1f3e4a5b6c7d"
    }
  })
});

const data = await response.json();

if (data.data.removeAuthorizedUser.success) {
  console.log('Authorized user removed:', data.data.removeAuthorizedUser);
} else {
  console.error('Remove authorized user failed:', data.data.removeAuthorizedUser.error);
}

Códigos de error

Código	Mensaje	Descripción
`ARG-0002`	Missing required arguments	No se proporcionó `authUserId`.
`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 Básica no tiene una cuenta de operador configurada. Verifica tus credenciales de autenticación.
`AUTH-0031`	The requested scopes must be granted by the user first.	Al token le falta el scope `MANAGE_SUBUSERS` requerido para gestionar usuarios autorizados.
`AUTH-0034`	No role assignment found for the provided authorized user on the specified account.	El `authUserId` no existe en la cuenta del solicitante o la asignación ya está `INACTIVE`.
`AUTH-0036`	The account owner cannot be removed.	La asignación de rol referenciada tiene el rol `OWNER` y no puede eliminarse mediante este endpoint.
`AUTH-0037`	Unable to manage authorized user. Please try again or contact support.	Se produjo una falla general al desactivar la asignación de rol. Intenta nuevamente o contacta al soporte.

​Parámetros

​Respuesta

​Respuesta exitosa

​Campos de la respuesta

​Ejemplo de solicitud

​Códigos de error

Parámetros

Respuesta

Respuesta exitosa

Campos de la respuesta

Ejemplo de solicitud

Códigos de error