Method: projects.locations.phoneNumbers.delete

Requests deletion of a PhoneNumber. The PhoneNumber is moved into the DELETE_REQUESTED state immediately, and is deleted approximately 30 days later. This method may only be called on a PhoneNumber in the ACTIVE state.

HTTP request

DELETE https://{endpoint}/v2beta1/{name=projects/*/locations/*/phoneNumbers/*}

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The unique identifier of the PhoneNumber to delete. Format: projects/<Project ID>/phoneNumbers/<PhoneNumber ID>. Format: projects/<Project ID>/locations/<Location ID>/phoneNumbers/<PhoneNumber ID>.

Authorization requires the following IAM permission on the specified resource name:

  • dialogflow.phoneNumbers.delete

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of PhoneNumber.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/dialogflow

For more information, see the Authentication Overview.