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. Note that row key prefixes used here are treated as service data. For more information about how service data is handled, see the Google Cloud Privacy Notice.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. 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 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 is empty.

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.