Method: projects.locations.queues.tasks.delete

Stay organized with collections Save and categorize content based on your preferences.

Deletes a task.

A task can be deleted if it is scheduled or dispatched. A task cannot be deleted if it has executed successfully or permanently failed.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The task name. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID

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

  • cloudtasks.tasks.delete

Request body

The request body must be empty.

Response body

If successful, the response body will be empty.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.