# delete users

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /be/v1/users/{username}:
    delete:
      summary: delete users
      deprecated: false
      description: >-
        This endpoint deletes a user.


        ### Required Permissions


        `users.delete` or being the user itself.


        See [Roles](https://edge.api.cloud.rockitplay.com/roles-3618377f0.md)
        for more details.
      tags:
        - ROCKIT Edge - Backend API/Account Management
      parameters:
        - name: username
          in: path
          description: ''
          required: true
          example: '{{machineUserName}}'
          schema:
            type: string
            pattern: /^[A-Za-z0-9_]{2,50}$/
        - name: Authorization
          in: header
          description: >-
            Use the access token obtained from [`POST
            /be/v1/login`](https://edge.api.cloud.rockitplay.com/user-login-org-11611254e0.md)
            or [`POST
            /be/v1/refresh`](https://edge.api.cloud.rockitplay.com/refresh-11630082e0.md)
            as Bearer token. <br>Mutually excluded with `x-rockit-api-key`.
          required: true
          example: Bearer {{_edge_org_admin_access_token}}
          schema:
            type: string
        - name: x-rockit-tenant
          in: header
          description: >
            Unique and immutable tenancy identifier obtained from the ROCKIT
            Edge administrator. <br>Requires `x-rockit-username`,
            `x-rockit-orgname` and `x-rockit-api-key`.
          required: true
          example: '{{EDGE_TENANT_NAME}}'
          schema:
            type: string
        - name: x-rockit-orgname
          in: header
          description: >
            Unique and immutable organization identifier obtained from the
            ROCKIT Edge administrator. <br>Requires `x-rockit-tenant`,
            `x-rockit-username` and `x-rockit-api-key`.
          required: true
          example: '{{EDGE_ORG_NAME}}'
          schema:
            type: string
        - name: x-rockit-username
          in: header
          description: >
            Unique and immutable username which is associated with the apikey.
            <br>Requires `x-rockit-tenant`, `x-rockit-orgname` and
            `x-rockit-api-key`.
          required: true
          example: adminPrincipal
          schema:
            type: string
        - name: x-rockit-api-key
          in: header
          description: >-
            Unique and immutable apikey which is associated with an machine
            user. <br>Mutually excluded with `Authorization` header. Requires
            `x-rockit-tenant`, `x-rockit-username` and `x-rockit-orgname`.
          required: true
          example: '{{_adminPrincipal_apiKey}}'
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: >-
                      A string indicating that the user deletion operation was
                      successful.
                  message:
                    type: string
                    description: >-
                      Provides confirmation that the user has been deleted
                      (e.g., "user deleted").
                required:
                  - status
                  - message
                x-apidog-orders:
                  - status
                  - message
                x--orders:
                  - status
                  - message
                x--ignore-properties: []
              examples:
                '1':
                  summary: Success
                  value:
                    status: success
                    message: user deleted
                '2':
                  summary: Unauthorized(401)
                  value:
                    status: string
                    error: string
                    message: string
          headers: {}
          x-apidog-name: OK
        '400':
          description: ''
          content:
            application/json:
              schema:
                title: ''
                type: object
                properties: {}
                x-apidog-orders:
                  - 01JQNGQ7TSQF893P3P0FK8NJ4Z
                x-apidog-refs:
                  01JQNGQ7TSQF893P3P0FK8NJ4Z:
                    $ref: '#/components/schemas/Invalid%20Param'
                x--orders: []
                x--ignore-properties: []
          headers: {}
          x-apidog-name: Invalid Param
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
                x-apidog-orders:
                  - 01JQNGPHTN7K4K0DAE3MECP1R1
                x-apidog-refs:
                  01JQNGPHTN7K4K0DAE3MECP1R1:
                    $ref: '#/components/schemas/unauthorized'
                x--orders: []
                x--ignore-properties: []
          headers: {}
          x-apidog-name: Unauthorized
        '409':
          description: ''
          content:
            application/json:
              schema:
                title: ''
                type: object
                properties: {}
                x-apidog-orders:
                  - 01JQNH91S1P1FQKTT2CGF1P170
                x-apidog-refs:
                  01JQNH91S1P1FQKTT2CGF1P170:
                    $ref: '#/components/schemas/Item-exists'
                x--orders: []
                x--ignore-properties: []
          headers: {}
          x-apidog-name: Item protected
      security: []
      x-apidog-folder: ROCKIT Edge - Backend API/Account Management
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/732774/apis/api-11634344-run
components:
  schemas:
    unauthorized:
      type: object
      properties:
        status:
          type: string
          description: >-
            Indicates that the organization creation request was rejected
            because of authentication problems.
        error:
          type: string
          description: Contains an error identifier. (e.g."unauthorized")
        message:
          type: string
          description: >-
            Provides details such as "invalid token" to help diagnose the
            failure.
      required:
        - status
        - error
        - message
      x-apidog-orders:
        - status
        - error
        - message
      x--orders:
        - status
        - error
        - message
      x--ignore-properties: []
      x-apidog-folder: ''
    Invalid Param:
      type: object
      properties:
        status:
          type: string
          description: >-
            Reflects that the creation failed due to one or more invalid or
            missing parameters in the request.
        error:
          type: string
          description: Contains an error identifier.  (e.g., "invalid-param")
        message:
          type: string
          description: >-
            Explains the nature of the invalid input (for example, "name
            invalid").
        detail:
          type: string
          description: >-
            Offers further context on the error. (e.g., expected pattern for the
            organization name)
      required:
        - status
        - error
        - message
        - detail
      x-apidog-orders:
        - status
        - error
        - message
        - detail
      x--orders:
        - status
        - error
        - message
        - detail
      x--ignore-properties: []
      x-apidog-folder: ''
    Item-exists:
      type: object
      properties:
        status:
          type: string
          description: >-
            Indicates that the request failed because an organization with the
            same identifier already exists or is protected.
        error:
          type: string
          description: Contains an error identifier.  (e.g., "item exists")
        message:
          type: string
          description: States that the organization cannot be created due to a conflict.
        detail:
          type: string
          description: Provides additional context.
      required:
        - status
        - error
        - message
        - detail
      x-apidog-orders:
        - status
        - error
        - message
        - detail
      x--orders:
        - status
        - error
        - message
        - detail
      x--ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    Bearer token:
      type: bearer
      scheme: bearer
      description: >-
        Enter your Access Token. You can obtain this by calling the /be/v1/login
        endpoint. Use the Refresh token to get a new Access token when it
        expires.
servers:
  - url: https://Example-Server.com
    description: Default
security: []

```