tencent cloud


Deleting User Attributes

Last updated: 2022-06-21 15:45:39

    Feature Description

    This API is used by the admin to delete attributes for users. Each request can delete attributes for a maximum of 100 users.Before using this API, be sure to Set User Attributes.

    API Call Description

    The feature is available only to users with Flagship edition accounts. See Configuration Change Ticket to apply for this feature. The feature will be enabled 48 hours after your application is approved.

    Sample request URL


    Request parameters

    Parameter Description
    https The request protocol is HTTPS, and the request method is POST.
    xxxxxx The country/region where your SDKAppID is located.
  • China: console.tim.qq.com
  • Singapore: adminapisgp.im.qcloud.com
  • Seoul: adminapikr.im.qcloud.com
  • Frankfurt: adminapiger.im.qcloud.com
  • India: adminapiind.im.qcloud.com
  • v4/all_member_push/im_remove_attr Request API
    usersig The signature generated by the app admin account. For more information, see UserSig backend API.
    identifier It must be the app admin account.
    sdkappid The SDKAppID assigned by the IM console when the app is created.
    random A random 32-bit unsigned integer.
    contenttype Fixed value: JSON

    Maximum call frequency

    100 times/second.

    Sample request packet

    "UserAttrs": [
        "To_Account": "xiaojun013",
        "Attrs": [
        "To_Account": "xiaojun012",
        "Attrs": [

    Request packet fields

    Field Type Required Description
    To_Account String Required Target user account
    Attrs Array Required Tag set. Note that you only need to specify the attribute names here. For more information on the format and meanings of Attrs, see the descriptions of the push request packet fields.

    Sample response packet

      "ActionStatus": "OK",
      "ErrorInfo": "",
      "ErrorCode": 0

    Response packet fields

    Field Type Description
    ActionStatus String The processing result of the request. OK: succeeded. FAIL: failed.
    ErrorCode Integer Error code
    ErrorInfo String Error information

    Error Codes

    The HTTP return code for this API is 200 unless a network error such as error 502 occurs. The actual error code and error information are indicated by ErrorCode and ErrorInfo in the response packet. For public error codes 60000 to 79999, see Error Codes.
    The list below contains only error codes specific to this API:

    Error Code Description
    90001 Failed to parse the JSON format. Check whether the JSON request packet meets JSON specifications.
    90009 The request requires the app admin’s permissions.
    90018 The number of accounts requested exceeds the limit.
    90033 Attributes are invalid.
    91000 An internal service error occurs. Please try again.

    API Debugging Tool

    To debug this API, you can use the Online RESTful API Debugging Tool.


    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support