---
updatedAt: 2026-09-26T02:51:07.000Z
agentTools:
  projectIndex: https://developers.dialpad.com/llms.txt
---

# Call Centers -- Delete

Deletes a call center by id.

Requires a company admin API key.

Rate limit: 1200 per minute.

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "protos.group.AdvancedSettings": {
        "properties": {
          "auto_call_recording": {
            "$ref": "#/components/schemas/protos.group.AutoCallRecording",
            "description": "Choose which calls to and from this call center get automatically recorded. Recordings are only available to administrators of this call center, which can be found in the Dialpad app and the Calls List.",
            "type": [
              "null",
              "object"
            ]
          },
          "max_wrap_up_seconds": {
            "description": "Include a post-call wrap-up time before agents can receive their next call. Default is 0.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "protos.group.Alerts": {
        "properties": {
          "cc_service_level": {
            "description": "Alert supervisors when the service level drops below how many percent. Default is 95%.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "cc_service_level_seconds": {
            "description": "Inbound calls should be answered within how many seconds. Default is 60.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "protos.group.AutoCallRecording": {
        "properties": {
          "allow_pause_recording": {
            "description": "Allow agents to stop/restart a recording during a call. Default is False.",
            "type": [
              "boolean",
              "null"
            ]
          },
          "call_recording_inbound": {
            "description": "Whether or not inbound calls to this call center get automatically recorded. Default is False.",
            "type": [
              "boolean",
              "null"
            ]
          },
          "call_recording_outbound": {
            "description": "Whether or not outbound calls from this call center get automatically recorded. Default is False.",
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "protos.group.CallCenterProto": {
        "properties": {
          "advanced_settings": {
            "$ref": "#/components/schemas/protos.group.AdvancedSettings",
            "description": "Configure call center advanced settings.",
            "type": [
              "null",
              "object"
            ]
          },
          "alerts": {
            "$ref": "#/components/schemas/protos.group.Alerts",
            "description": "Set when alerts will be triggered.",
            "type": [
              "null",
              "object"
            ]
          },
          "availability_status": {
            "description": "Availability status of the group.",
            "enum": [
              "closed",
              "holiday_closed",
              "holiday_open",
              "open",
              null
            ],
            "type": [
              "null",
              "string"
            ]
          },
          "country": {
            "description": "The country in which the user group resides.",
            "type": [
              "null",
              "string"
            ]
          },
          "first_action": {
            "description": "The initial action to take upon receiving a new call.",
            "enum": [
              "menu",
              "operators",
              null
            ],
            "type": [
              "null",
              "string"
            ]
          },
          "friday_hours": {
            "description": "The Friday hours of operation. Default value is [\"08:00\", \"18:00\"]",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "group_description": {
            "description": "The description of the call center.",
            "type": [
              "null",
              "string"
            ]
          },
          "hold_queue": {
            "$ref": "#/components/schemas/protos.group.HoldQueueCallCenter",
            "description": "Configure how the calls are sent to a hold queue when all operators are busy on other calls.",
            "type": [
              "null",
              "object"
            ]
          },
          "hours_on": {
            "description": "The time frame when the call center wants to receive calls. Default value is false, which means the call center will always take calls (24/7).",
            "type": [
              "boolean",
              "null"
            ]
          },
          "id": {
            "description": "The ID of the group entity.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "is_digital": {
            "description": "Whether this is a digital call center. True for digital call centers, which handle digital engagement conversations, and False for voice call centers.",
            "type": [
              "boolean",
              "null"
            ]
          },
          "monday_hours": {
            "description": "The Monday hours of operation. To specify when hours_on is set to True. e.g. [\"08:00\", \"12:00\", \"14:00\", \"18:00\"] => open from 8AM to Noon, and from 2PM to 6PM. Default value is [\"08:00\", \"18:00\"].",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "name": {
            "description": "[single-line only]\n\nThe name of the group.",
            "type": [
              "null",
              "string"
            ]
          },
          "no_operators_action": {
            "description": "The action to take if there are no operators available to accept an inbound call.",
            "enum": [
              "ai_agent",
              "bridge_target",
              "call_service_target",
              "company_directory",
              "department",
              "directory",
              "disabled",
              "extension",
              "google_dialogflow",
              "last_name_company_directory",
              "last_name_directory",
              "menu",
              "message",
              "operator",
              "person",
              "recursive_transfer",
              "scripted_ivr",
              "voicemail",
              null
            ],
            "type": [
              "null",
              "string"
            ]
          },
          "office_id": {
            "description": "The ID of the office in which this group resides.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "phone_numbers": {
            "description": "A list of phone numbers belonging to this group.",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "ring_seconds": {
            "description": "The number of seconds to allow the group line to ring before going to voicemail.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "routing_options": {
            "$ref": "#/components/schemas/protos.group.RoutingOptions",
            "description": "Call routing options for this group.",
            "type": [
              "null",
              "object"
            ]
          },
          "saturday_hours": {
            "description": "The Saturday hours of operation. Default is empty array.",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "state": {
            "description": "The current enablement state of this group.",
            "enum": [
              "active",
              "cancelled",
              "deleted",
              "pending",
              "suspended",
              null
            ],
            "type": [
              "null",
              "string"
            ]
          },
          "sunday_hours": {
            "description": "The Sunday hours of operation. Default is empty array.",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "thursday_hours": {
            "description": "The Thursday hours of operation. Default value is [\"08:00\", \"18:00\"]",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "timezone": {
            "description": "The timezone of the group.",
            "type": [
              "null",
              "string"
            ]
          },
          "tuesday_hours": {
            "description": "The Tuesday hours of operation. Default value is [\"08:00\", \"18:00\"]",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "voice_intelligence": {
            "$ref": "#/components/schemas/protos.group.VoiceIntelligence",
            "description": "Configure voice intelligence.",
            "type": [
              "null",
              "object"
            ]
          },
          "voicemail_notification_emails": {
            "description": "List of emails used to send voicemail notifications.",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "wednesday_hours": {
            "description": "The Wednesday hours of operation. Default value is [\"08:00\", \"18:00\"]",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          }
        },
        "title": "Call center.",
        "type": "object"
      },
      "protos.group.DtmfMapping": {
        "properties": {
          "input": {
            "description": "The DTMF key associated with this menu item. (0-9)",
            "type": [
              "null",
              "string"
            ]
          },
          "options": {
            "$ref": "#/components/schemas/protos.group.DtmfOptions",
            "description": "The action that should be taken if the input key is pressed.",
            "type": [
              "null",
              "object"
            ]
          }
        },
        "type": "object"
      },
      "protos.group.DtmfOptions": {
        "properties": {
          "action": {
            "description": "The routing action type. Omit to leave an existing digit's action untouched (e.g. when only updating its target); send null to clear it.",
            "enum": [
              "ai_agent",
              "bridge_target",
              "call_service_target",
              "company_directory",
              "department",
              "directory",
              "disabled",
              "extension",
              "google_dialogflow",
              "last_name_company_directory",
              "last_name_directory",
              "menu",
              "message",
              "operator",
              "person",
              "recursive_transfer",
              "scripted_ivr",
              "voicemail"
            ],
            "type": "string"
          },
          "action_target_id": {
            "description": "The ID of the target that should be dialed. Omit both this and action_target_type to leave an existing target untouched; send both as null to clear it.",
            "format": "int64",
            "type": "integer"
          },
          "action_target_type": {
            "description": "The type of the target that should be dialed. Omit both this and action_target_id to leave an existing target untouched; send both as null to clear it.",
            "enum": [
              "callcenter",
              "callrouter",
              "channel",
              "coachinggroup",
              "contact",
              "contactgroup",
              "department",
              "office",
              "room",
              "staffgroup",
              "unknown",
              "user"
            ],
            "type": "string"
          }
        },
        "title": "DTMF routing options.",
        "type": "object"
      },
      "protos.group.HoldQueueCallCenter": {
        "properties": {
          "allow_queue_callback": {
            "description": "Whether or not to allow callers to request a callback. Default is False.",
            "type": [
              "boolean",
              "null"
            ]
          },
          "announce_estimated_wait_time": {
            "description": "Whether or not to let callers know their estimated wait time. Default is False.\n\nMutually exclusive with `announce_position`. Setting this to True in an update disables `announce_position`. If both fields are sent as True in the same payload, the server disables `announce_estimated_wait_time`.",
            "type": [
              "boolean",
              "null"
            ]
          },
          "announce_position": {
            "description": "Whether or not to let callers know their place in the queue. This option is not available when a maximum queue wait time of less than 2 minutes is selected. Default is True.",
            "type": [
              "boolean",
              "null"
            ]
          },
          "announcement_interval_seconds": {
            "description": "Hold announcement interval wait time. Default is 2 min.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "estimated_wait_time_max": {
            "description": "Maximum estimated wait time to announce in minutes. Default is 30 minutes.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "max_hold_count": {
            "description": "If all operators are busy on other calls, send callers to a hold queue. This is to specify your queue size. Choose from 1-1000. Default is 50.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "max_hold_seconds": {
            "description": "Maximum queue wait time in seconds. Choose from 30s to 18000s (3 hours). Default is 900s (15 min).",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "queue_callback_dtmf": {
            "description": "Allow callers to request a callback when the queue has more than queue_callback_threshold number of calls by pressing one of the followings: [0,1,2,3,4,5,6,7,8,9,*,#]. Default is 9.",
            "type": [
              "null",
              "string"
            ]
          },
          "queue_callback_threshold": {
            "description": "Allow callers to request a callback when the queue has more than this number of calls. Default is 5.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "queue_escape_dtmf": {
            "description": "Allow callers to exit the hold queue to voicemail by pressing one of the followings:\n[0,1,2,3,4,5,6,7,8,9,*,#]. Default is *.",
            "type": [
              "null",
              "string"
            ]
          },
          "stay_in_queue_after_closing": {
            "description": "Whether or not to allow existing calls to stay in queue after the call center has closed. Default is False.",
            "type": [
              "boolean",
              "null"
            ]
          },
          "unattended_queue": {
            "description": "Whether or not to allow callers to be placed in your hold queue when no agents are available. Default is False.",
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "protos.group.RoutingOptions": {
        "properties": {
          "closed": {
            "$ref": "#/components/schemas/protos.group.RoutingOptionsInner",
            "description": "Routing options to use during off hours.",
            "type": "object"
          },
          "open": {
            "$ref": "#/components/schemas/protos.group.RoutingOptionsInner",
            "description": "Routing options to use during open hours.",
            "type": "object"
          }
        },
        "required": [
          "closed",
          "open"
        ],
        "title": "Group routing options.",
        "type": "object"
      },
      "protos.group.RoutingOptionsInner": {
        "properties": {
          "action": {
            "description": "The action that should be taken if no operators are available.",
            "enum": [
              "ai_agent",
              "bridge_target",
              "call_service_target",
              "company_directory",
              "department",
              "directory",
              "disabled",
              "extension",
              "google_dialogflow",
              "last_name_company_directory",
              "last_name_directory",
              "menu",
              "message",
              "operator",
              "person",
              "recursive_transfer",
              "scripted_ivr",
              "voicemail"
            ],
            "type": "string"
          },
          "action_target_id": {
            "description": "The ID of the Target that inbound calls should be routed to. Omit both this and action_target_type to leave an existing target untouched; send both as null to clear it.",
            "format": "int64",
            "type": "integer"
          },
          "action_target_type": {
            "description": "The type of the Target that inbound calls should be routed to. Omit both this and action_target_id to leave an existing target untouched; send both as null to clear it.",
            "enum": [
              "callcenter",
              "callrouter",
              "channel",
              "coachinggroup",
              "contact",
              "contactgroup",
              "department",
              "office",
              "room",
              "staffgroup",
              "unknown",
              "user"
            ],
            "type": "string"
          },
          "dtmf": {
            "description": "DTMF menu options. Sending an empty list clears the whole menu.",
            "items": {
              "$ref": "#/components/schemas/protos.group.DtmfMapping",
              "type": "object"
            },
            "type": "array"
          },
          "operator_routing": {
            "description": "The routing strategy that should be used when dialing operators.",
            "enum": [
              "autopark",
              "fixedorder",
              "longestidle",
              "mostskilled",
              "pinned_leg",
              "plivo_address",
              "random",
              "roundrobin",
              "simultaneous",
              "skills_based"
            ],
            "type": "string"
          },
          "try_dial_operators": {
            "description": "Whether operators should be dialed on inbound calls.",
            "type": "boolean"
          }
        },
        "required": [
          "action",
          "try_dial_operators"
        ],
        "title": "Group routing options for open or closed states.",
        "type": "object"
      },
      "protos.group.VoiceIntelligence": {
        "properties": {
          "allow_pause": {
            "description": "Allow individual users to start and stop Vi during calls. Default is True.",
            "type": [
              "boolean",
              "null"
            ]
          },
          "auto_start": {
            "description": "Auto start Vi for this call center. Default is True.",
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearer_token": {
        "description": "The API key can be put in the Authorization header.\ni.e. Authorization: Bearer <api_key>",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Dialpad's APIs for customer and third-party developer use",
    "title": "Dialpad",
    "version": "v2",
    "x-logo": {
      "altText": "Dialpad",
      "url": "https://storage.googleapis.com/dialpad_openapi_specs/logo.png"
    }
  },
  "openapi": "3.1.0",
  "paths": {
    "/api/v2/callcenters/{id}": {
      "delete": {
        "deprecated": false,
        "description": "Deletes a call center by id.\n\nRequires a company admin API key.\n\nRate limit: 1200 per minute.",
        "operationId": "callcenters.delete",
        "parameters": [
          {
            "description": "The call center's id.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/protos.group.CallCenterProto"
                }
              }
            },
            "description": "A successful response"
          }
        },
        "summary": "Call Centers -- Delete",
        "tags": [
          "callcenters"
        ],
        "x-access": [
          "admin"
        ],
        "x-ratelimit": [
          [
            20,
            1
          ]
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://dialpad.com"
    },
    {
      "url": "https://sandbox.dialpad.com"
    }
  ],
  "security": [
    {
      "bearer_token": []
    }
  ],
  "x-readme": {
    "apply-tag-changes": true,
    "explorer-enabled": true,
    "proxy-enabled": false
  }
}
```