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

# Remove an User's Phone Number

> Clears the user's phone number and country code together. Idempotent: removing an already-absent phone succeeds. Refused with 409 / IDE-0056 while the user's SMS MFA channel is enabled, because SMS codes are delivered to that number — disable the SMS channel first. This is NOT achievable through PATCH /v1/users/{id}, which ignores an empty phone by design.



## OpenAPI

````yaml /en/openapi/v3-current/AM-identity.yaml delete /v1/users/{id}/phone
openapi: 3.0.1
info:
  contact: {}
  description: This is a swagger documentation for the Identity API
  termsOfService: http://swagger.io/terms/
  title: Identity API
  version: 1.0.0
servers:
  - url: //localhost:4001/
security: []
paths:
  /v1/users/{id}/phone:
    delete:
      tags:
        - Users
      summary: Remove an User's Phone Number
      description: >-
        Clears the user's phone number and country code together. Idempotent:
        removing an already-absent phone succeeds. Refused with 409 / IDE-0056
        while the user's SMS MFA channel is enabled, because SMS codes are
        delivered to that number — disable the SMS channel first. This is NOT
        achievable through PATCH /v1/users/{id}, which ignores an empty phone by
        design.
      parameters:
        - description: Target User ID
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '204':
          content: {}
          description: No Content
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pkg.HTTPError'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pkg.HTTPError'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pkg.HTTPError'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pkg.HTTPError'
          description: Not Found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pkg.HTTPError'
          description: SMS MFA is enabled for this user (IDE-0056)
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pkg.HTTPError'
          description: Internal Server Error
      security:
        - BearerAuth: []
components:
  schemas:
    pkg.HTTPError:
      properties:
        code:
          type: string
        entityType:
          type: string
        err:
          type: object
        message:
          type: string
        title:
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      description: 'Bearer authentication. Send Authorization: Bearer <token>.'
      in: header
      name: Authorization
      type: apiKey

````