移除授權使用者

透過停用其角色指派，從呼叫者的帳戶移除授權使用者。此 mutation 不會刪除該使用者——它會將呼叫者帳戶上的角色指派設為 INACTIVE，以撤銷其存取權。帳戶擁有者（OWNER 角色）無法透過此端點被移除。目標帳戶一律由呼叫者的認證解析——Bearer 權杖使用權杖所屬的帳戶；Basic（API key）呼叫者使用應用程式已設定的營運者帳戶。authUserId 必須指向該帳戶上的角色指派；否則請求會被拒絕。 🔒 受限存取此 mutation 需要 MANAGE_SUBUSERS 權限範圍。它同時支援 Bearer（使用者存取權杖）與 Basic（<API_KEY>）驗證。

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

參數

參數	型別	必填	說明
authUserId	UUID	Yes	要停用的授權使用者 ID（UAC 角色指派 ID）。可從 `authorizedUsers` 或 `addAuthorizedUser` 取得。

回應

成功回應

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

回應欄位

欄位	型別	說明
`success`	Boolean	若角色指派成功停用則為 `true`。
`authUserId`	UUID	已更新的授權使用者 ID（UAC 角色指派 ID）。
`status`	UACRoleStatusType	角色指派的更新狀態。成功時為 `INACTIVE`。
`error`	AuthorizedUserError	若 `success` 為 false，則為包含 `code` 與 `message` 的錯誤物件。

此 mutation 會在回應資料中回傳錯誤，而非作為 GraphQL 錯誤。請務必檢查 success 欄位，且在 success 為 false 時處理 error 物件。

範例請求

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);
}

錯誤代碼

代碼	訊息	說明
`ARG-0002`	缺少必要的參數	未提供 `authUserId`。
`AUTH-0008`	無效的使用者存取	無法從存取權杖或 API key 解析呼叫者，或是使用 Basic 驗證的應用程式未設定營運者帳戶。請驗證您的驗證憑證。
`AUTH-0031`	必須先由使用者授予所要求的權限範圍。	權杖缺少管理授權使用者所需的 `MANAGE_SUBUSERS` 權限範圍。
`AUTH-0034`	在指定帳戶上找不到所提供授權使用者的角色指派。	`authUserId` 並不存在於呼叫者的帳戶上，或該指派已為 `INACTIVE`。
`AUTH-0036`	無法移除帳戶擁有者。	參照的角色指派持有 `OWNER` 角色，且無法透過此端點移除。
`AUTH-0037`	無法管理授權使用者。請再試一次或聯絡支援。	在停用角色指派時發生一般性失敗。請重試或聯絡支援。

​參數

​回應

​成功回應

​回應欄位

​範例請求

​錯誤代碼

參數

回應

成功回應

回應欄位

範例請求

錯誤代碼