Method: projects.instances.tables.dropRowRange

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

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 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.