Phone Numbers - Delete Reservation

Service:: Communication

API Version:: 2025-06-01

Deletes a reservation by its ID.
Deletes the reservation with the given ID. Any phone number in the reservation will be released and made available for others to purchase. Only reservations with 'active' status can be deleted.

DELETE {endpoint}/availablePhoneNumbers/reservations/{reservationId}?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
reservationId	path	True	string (uuid)	The id of the reservation.
api-version	query	True	string	Version of API to invoke

Responses

Name	Type	Description
204 No Content		Reservation successfully deleted.
Other Status Codes	CommunicationErrorResponse	Failure

Examples

Delete reservation

Sample request

HTTP

DELETE https://resourcename.communication.azure.com/availablePhoneNumbers/reservations/65c18c7f-8074-4efb-a572-e0df127a9964?api-version=2025-06-01

Sample response

Status code:: 204

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