# 撤销权益（管理）

撤销用户的权益。

注意：仅可撤销DRM free平台的游戏Key或游戏。

Endpoint: POST /v2/project/{project_id}/admin/entitlement/revoke
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    项目ID。您可以在发布商帐户的项目名称旁找到此参数；使用项目时，也可以在浏览器地址栏中找到此参数。URL格式如下：https://publisher.xsolla.com//projects/。
    Example: 44056

## Request fields (application/json):

  - `user_external_id` (string, required)
    唯一用户标识符。
    Example: "user-external-id"

  - `game` (object, required)
    包含游戏属性的对象。
    Example: {"sku":"com.xsolla.game_1"}

  - `game.sku` (string, required)
    唯一游戏Key套餐ID。
    Example: "com.xsolla.game_1"

  - `drm` (object, required)
    包含DRM属性的对象。
    Example: {"sku":"com.xsolla.key_1"}

  - `drm.sku` (string, required)
    唯一DRM ID。
    Enum: "steam", "playstation", "xbox", "uplay", "origin", "drmfree", "gog", "epicgames", "nintendo_eshop", "discord_game_store", "oculus", "rockstar", "viveport", "stadia"

  - `mode` (string, required)
    应该撤销什么类型的权利。如果该参数设置为sandbox，则将在沙盒模式下撤销用户权利。如果该参数设置为default，则在实时模式下撤销用户权利。
    Enum: "default", "sandbox"

## Response 403 fields (application/json):

  - `statusCode` (integer)
    Example: 403

  - `errorCode` (integer)

  - `errorMessage` (string)
    Example: "Authorization header not sent."

  - `transactionId` (string)
    Example: "x-x-x-x-transactionId-mock-x-x-x"

## Response 422 fields (application/json):

  - `statusCode` (integer)
    Example: 422

  - `errorCode` (integer)
    Example: 5103

  - `errorMessage` (string)
    Example: "[0401-5103]: Selected drm is not drmfree."

  - `transactionId` (string)
    Example: "x-x-x-x-transactionId-mock-x-x-x"


## Response 204 fields