---
title: "Deletes all numbers associated with a phone number block"
method: POST
path: "/phone_number_blocks/jobs/delete_phone_number_block"
tags: ["Phone Number Blocks Background Jobs"]
---

# Deletes all numbers associated with a phone number block

`POST /phone_number_blocks/jobs/delete_phone_number_block`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/phone_number_blocks/jobs/delete_phone_number_block`
- Auth: HTTP bearer

Creates a new background job to delete all the phone numbers associated with the given block. We will only consider the phone number block as deleted after all phone numbers associated with it are removed, so multiple executions of this job may be necessary in case some of the phone numbers present errors during the deletion process.

## Request body

- PhoneNumberBlocksJobDeletePhoneNumberBlockRequest
  - `phone_number_block_id` string, required

## Response `202`

Block deletion job accepted. The response contains a background job; poll GET /phone_numbers/jobs/{id} with the job id until it completes.

- object
  - `data` PhoneNumberBlocksJob
    - `id` string, uuid: Identifies the resource.
    - `record_type` string: Identifies the type of the resource.
    - `status` 'pending' | 'in_progress' | 'completed' | 'failed': Indicates the completion status of the background operation.
    - `type` 'delete_phone_number_block': Identifies the type of the background job.
    - `etc` string, date-time: ISO 8601 formatted date indicating when the estimated time of completion of the background job.
    - `created_at` string: ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string: ISO 8601 formatted date indicating when the resource was updated.
    - `successful_operations` PhoneNumberBlocksJobSuccessfulOperation[]
      - `phone_number` string: The phone number in e164 format.
      - `id` string: The phone number's ID
    - `failed_operations` PhoneNumberBlocksJobFailedOperation[]
      - `phone_number` string: The phone number in e164 format.
      - `id` string: The phone number's ID
      - `errors` NumbersError[]
        - `code` string
        - `title` string
        - `detail` string
        - `source` object
          - `pointer` string: JSON pointer (RFC6901) to the offending entity.
          - `parameter` string: Indicates which query parameter caused the error.
        - `meta` object
          - `url` string: URL with additional information on the error.

## Other responses

- `400`: Bad request, the request was unacceptable, often due to missing a required parameter.
- `401`: Unauthorized
- `404`: The requested resource doesn't exist.
- `422`: Unprocessable entity. Check the 'detail' field in response for details.
- `500`: Unexpected error

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-21** `19db5ee4ec59`: 5 breaking, 5 info
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `400`
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `401`
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `404`
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `422`
  - …6 more
- **2026-09-16** `a6a61a29ecdd`: 5 breaking, 5 warning, 10 info
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `400`
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `401`
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `404`
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `422`
  - …16 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/phone_number_blocks/jobs/delete_phone_number_block/post.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)