Method: organizations.locations.workloads.delete

Deletes the workload. Make sure that workload's direct children are already in a deleted state, otherwise the request will fail with a FAILED_PRECONDITION error. In addition to assuredworkloads.workload.delete permission, the user should also have orgpolicy.policy.set permission on the deleted folder to remove Assured Workloads OrgPolicies.

HTTP request

DELETE https://{endpoint}/v1/{name=organizations/*/locations/*/workloads/*}

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

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The name field is used to identify the workload. Format: organizations/{org_id}/locations/{locationId}/workloads/{workload_id}

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

  • assuredworkloads.workload.delete

Query parameters



Optional. The etag of the workload. If this is provided, it must match the server's etag.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • assuredworkloads.workload.delete

For more information, see the IAM documentation.