Share via

Phone Numbers - Release Phone Number

  • Reference
Service:
Communication
API Version:
2021-03-07

Releases a purchased phone number.

DELETE {endpoint}/phoneNumbers/{phoneNumber}?api-version=2021-03-07

URI Parameters

Name In Required Type Description
endpoint
 path True

string

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' and 'Location' headers. Client side should further query the operation status using the URL specified in 'Operation-Location' header. When operation completes successfully query final result using URL specified in 'Location' header.

Headers

  • Operation-Location: string
  • operation-id: string
  • release-id: string
Other Status Codes

CommunicationErrorResponse

Failure

Examples

Release phone number

Sample request

DELETE https://resourcename.communication.azure.com//phoneNumbers/+11234567890?api-version=2021-03-07

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

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

The Communication Services error.

Name Type Description
error

CommunicationError

The Communication Services error.