Method: projects.instances.tables.dropRowRange

Permanently drop/delete a row range from a specified table. The request can specify whether to delete all rows in a table, or only those that match a particular prefix.

HTTP request


The URL uses Google API HTTP annotation syntax.

Path parameters



The unique name of the table on which to drop a range of rows. Values are of the form projects/<project>/instances/<instance>/tables/<table>.

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

  • bigtable.tables.mutateRows

Request body

The request body contains data with the following structure:

JSON representation

  // Union field target can be only one of the following:
  "rowKeyPrefix": string,
  "deleteAllDataFromTable": boolean,
  // End of list of possible types for union field target.
Union field target. Delete all rows or by prefix. target can be only one of the following:

string (bytes format)

Delete all rows that start with this row key prefix. Prefix cannot be zero length.

A base64-encoded string.



Delete all rows in the table. Setting this to false is a no-op.

Response body

If successful, the response body will be empty.


Requires one of the following OAuth scopes:


For more information, see the Auth Guide.

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

Cloud Bigtable Documentation