> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cog888.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Control User

> Control user status (freeze/unfreeze/kick)

<Accordion title="Possible Error Codes for this API">
  | Code | Description           |
  | ---- | --------------------- |
  | 0    | Success               |
  | 2    | Invalid parameter     |
  | 19   | Request limit reached |
  | 20   | Secret key error      |
  | 21   | Invalid username      |
  | 25   | Type parameter error  |
  | 36   | Server error          |
  | 9999 | Unknown error         |
</Accordion>


## OpenAPI

````yaml en/transfer-openapi.json PUT /api/v1/dt/user/status
openapi: 3.1.0
info:
  title: Transfer Wallet API
  description: Game-API for vendors to obtain game-related data
  version: 1.0.0
servers:
  - url: https://api.example.com
    description: Production server
security: []
paths:
  /api/v1/dt/user/status:
    put:
      tags:
        - User API
      summary: Control User
      description: Control user status (freeze/unfreeze/kick)
      operationId: controlUser
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uuid
                - platform_id
                - username
                - type
                - key
              properties:
                uuid:
                  type: string
                  description: >-
                    Platform-defined unique request ID, length >= 32 and <= 128
                    bytes
                platform_id:
                  type: string
                  description: Platform product ID
                username:
                  type: string
                  description: >-
                    User account in game (max 23 characters, lowercase letters
                    and numbers only)
                type:
                  type: string
                  description: >-
                    Control type: 0 - Enable, 1 - Disable (force disconnect
                    online users), 2 - Suspend (do not force disconnect)
                key:
                  type: string
                  description: md5(type + username + platform secret key)
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
              example:
                error:
                  code: 0
                  msg: Success
                  uuid: e69da788a6c841d4953c475fc42bf464
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: 2
                  msg: >-
                    request hash signature(0FACF22B9E3DB5CDC670A0F7A65BB76A) is
                    error
                  uuid: 9e96610f-5388-42df-b3ed-ba1b3178c63b
components:
  schemas:
    SuccessResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ErrorInfo'
    Error:
      type: object
      properties:
        code:
          type: string
          description: Error code
        message:
          type: string
          description: Error message
        data:
          description: Data (usually null)
        status_code:
          type: integer
          description: HTTP status code
        service:
          type: string
          description: Service name
    ErrorInfo:
      type: object
      properties:
        code:
          type: integer
          description: Error code
        msg:
          type: string
          description: Error message
        uuid:
          type: string
          description: Request ID

````