Method: projects.locations.apps.tools.delete

Deletes the specified tool.

HTTP request

DELETE https://ces.googleapis.com/v1/{name=projects/*/locations/*/apps/*/tools/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The resource name of the tool to delete.

Query parameters

Parameters
force

boolean

Optional. Indicates whether to forcefully delete the tool, even if it is still referenced by agents/examples.

  • If force = false, the deletion will fail if any agents still reference the tool.
  • If force = true, all existing references from agents will be removed and the tool will be deleted.
etag

string

Optional. The current etag of the tool. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the tool, deletion will be blocked and an ABORTED error will be returned.

Request body

The request body must be empty.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • ces.tools.delete

For more information, see the IAM documentation.