# Delete role Delete a role ## Prerequisite To call the custom role-related APIs, you need to ensure that Base has enabled advanced permissions. You can enable advanced permissions through the [Update Base Metadata](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/update) API. ## Request Facts |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/bitable/v1/apps/:app_token/roles/:role_id HTTP Method | DELETE Rate Limit | [10 per second](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) Supported app types | Custom App、Store App Required scopes
**To use this API, you must have at least 1 of the listed scopes.** | View, comment, edit and manage Base(bitable:app) ### Request header Parameter | Type | Required | Description ---|---|---|--- Authorization | string | Yes | `tenant_access_token`
or
`user_access_token`
**Value format**: "Bearer `access_token`"
**Example value**: "Bearer u-7f1bcd13fc57d46bac21793a18e560"
[How to choose and get access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) ### Path parameters Parameter | Type | Description ---|---|--- app_token | string | Base unique device identifier [app_token description](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification#8121eebe)
**Example value**: "appbcbWCzen6D8dezhoCH2RpMAh" role_id | string | Role id
**Example value**: "roljRpwIUt" ## Response ### Response body Parameter | Type | Description ---|---|--- code | int | Error codes, fail if not zero msg | string | Error descriptions data | \- | \- ### Response body example ```json { "code": 0, "msg": "success", "data": {} } ``` ### Error code HTTP status code | Error code | Description | Troubleshooting suggestions ---|---|---|--- 200 | 1254000 | WrongRequestJson | Request error 200 | 1254001 | WrongRequestBody | Request body error 200 | 1254002 | Fail | Internal error, have any questions can be consulting service 200 | 1254003 | WrongBaseToken | AppToken error 200 | 1254010 | ReqConvError | Request error 400 | 1254032 | InvalidRoleName | Invalid role name 400 | 1254033 | RoleNameDuplicated | Role name duplicated 400 | 1254036 | Base is copying, please try again later. | Base copy replicating, try again later 200 | 1254040 | BaseTokenNotFound | AppToken not found 404 | 1254047 | RoleIdNotFound | Role not found 400 | 1254110 | RoleExceedLimit | Role exceed limit, limited to 30 200 | 1254290 | TooManyRequest | Request too fast, try again later 200 | 1254291 | Write conflict | The same data table does not support concurrent calls to the write interface, please check whether there is a concurrent call to the write interface. The writing interface includes: adding, modifying, and deleting records; adding, modifying, and deleting fields; modifying forms; modifying views, etc. 400 | 1254301 | OperationTypeError | Base does not have advanced permissions enabled or does not support enabling advanced permissions 403 | 1254302 | Permission denied. | No access rights, usually caused by the table opening of advanced permissions, please add a group containing applications in the advanced permissions settings and give this group read and write permissions 200 | 1255001 | InternalError | Internal error, have any questions can be consulting service 200 | 1255002 | RpcError | Internal error, have any questions can be consulting service 200 | 1255003 | MarshalError | Serialization failed, have any questions can be consulting service 200 | 1255004 | UmMarshalError | Deserialization failed, have any questions can be consulting service 504 | 1255040 | Request timed out, please try again later | Try again