Phone Numbers - Release Phone Number

Service:

Communication

API Version:

2025-06-01

Releases a purchased phone number.

DELETE {endpoint}/phoneNumbers/{phoneNumber}?api-version=2025-06-01

URI Parameters

Name	In	Required	Type	Description
endpoint	path	True	string (url)	The communication resource, for example https://resourcename.communication.azure.com
phoneNumber	path	True	string	Phone number to be released, e.g. +11234567890.
api-version	query	True	string	Version of API to invoke

Responses

Name	Type	Description
202 Accepted		The service has accepted the request and will start processing later. It will return 'Accepted' immediately and include an 'Operation-Location' header. Client side should further query the operation status using the URL specified in 'Operation-Location' header. Headers Operation-Location: string operation-id: string release-id: string
Other Status Codes	CommunicationErrorResponse	Failure

Examples

Release phone number

Sample request

HTTP

DELETE https://resourcename.communication.azure.com//phoneNumbers/+11234567890?api-version=2025-06-01

Sample response

Status code:

202

Operation-Location: /phoneNumbers/operations/release_378ddf60-81be-452a-ba4f-613198ea6c28
operation-id: release_378ddf60-81be-452a-ba4f-613198ea6c28
release-id: 378ddf60-81be-452a-ba4f-613198ea6c28

Definitions

Name	Description
CommunicationError	The Communication Services error.
CommunicationErrorResponse	The Communication Services error.

CommunicationError

Object

The Communication Services error.

Name	Type	Description
code	string	The error code.
details	CommunicationError[]	Further details about specific errors that led to this error.
innererror	CommunicationError	The inner error if any.
message	string	The error message.
target	string	The error target.

CommunicationErrorResponse

Object

The Communication Services error.

Name	Type	Description
error	CommunicationError	The Communication Services error.