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

# Unassign Phone Number by String

> Unassign a phone number from an assistant by phone number string.

This endpoint unassigns a phone number from an assistant, making it available again within your organization's pool. The phone number is not deleted from your account, but it will no longer route calls to this assistant.

### Path Parameters

* `assistant_id` (string, **required**): The unique identifier of the assistant from whom the phone number will be unassigned.

### Request Body

* `phone_number` (string, **required**): The phone number to unassign, specified in E.164 format (e.g., `+15551234567`).

```json Request theme={null}
{
  "phone_number": "+15551234567"
}
```

### Response

A successful request will return the updated phone number object, where the `assistant_id` is now `null`.

```json Response theme={null}
{
  "id": "pn_1a2b3c4d5e6f7g8h",
  "phone_number": "+15551234567",
  "assistant_id": null,
  "organization_id": "org_67890",
  "created_at": "2023-10-26T11:00:00Z",
  "updated_at": "2023-10-28T15:00:00Z"
}
```


## OpenAPI

````yaml POST /api/v1/assistants/{assistant_id}/phone-numbers/unassign-by-number
openapi: 3.1.0
info:
  title: Burki
  description: A system that uses AI to answer customer Calls.
  version: 0.1.0
servers: []
security: []
paths:
  /api/v1/assistants/{assistant_id}/phone-numbers/unassign-by-number:
    post:
      tags:
        - assistants
      summary: Unassign Phone Number By String
      description: Unassign a phone number from an assistant by phone number string.
      operationId: >-
        unassign_phone_number_by_string_api_v1_assistants__assistant_id__phone_numbers_unassign_by_number_post
      parameters:
        - name: assistant_id
          in: path
          required: true
          schema:
            type: integer
            title: Assistant Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PhoneNumberUnassignRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    PhoneNumberUnassignRequest:
      properties:
        phone_number:
          type: string
          title: Phone Number
          description: Phone number to unassign
      type: object
      required:
        - phone_number
      title: PhoneNumberUnassignRequest
      description: Schema for unassigning a phone number from an assistant.
    APIResponse:
      properties:
        success:
          type: boolean
          title: Success
        message:
          type: string
          title: Message
        data:
          anyOf:
            - {}
            - type: 'null'
          title: Data
      type: object
      required:
        - success
        - message
      title: APIResponse
      description: Standard API response format.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````