Method: projects.locations.apis.versions.specs.delete

Delete a spec. Deleting a spec will also delete the associated operations from the version and remove any links between the spec and deployments.

HTTP request

DELETE https://apihub.googleapis.com/v1/{name=projects/*/locations/*/apis/*/versions/*/specs/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the spec to delete. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}

Request body

The request body must be empty.

Response body

If successful, the response body is an empty JSON object.

Authorization scopes

Requires one of the following OAuth scopes:

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

IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.specs.delete

For more information, see the IAM documentation.