---
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`

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
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `etc` string, date-time — ISO 8601 formatted date indicating when the estimated time of completion of the background job.
    - `failed_operations` NumbersPhoneNumberBlocksJobFailedOperation[]
      - `errors` NumbersError[]
        - `code` string
        - `detail` string
        - `meta` object
          - `url` string — URL with additional information on the error.
        - `source` object
          - `parameter` string — Indicates which query parameter caused the error.
          - `pointer` string — JSON pointer (RFC6901) to the offending entity.
        - `title` string
      - `id` string — The phone number's ID
      - `phone_number` string — The phone number in e164 format.
    - `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.
    - `successful_operations` PhoneNumberBlocksJobSuccessfulOperation[]
      - `id` string — The phone number's ID
      - `phone_number` string — The phone number in e164 format.
    - `type` 'delete_phone_number_block' — Identifies the type of the background job.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.

## 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

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)