Method: controller.debuggees.breakpoints.list

Returns the list of all active breakpoints for the debuggee.

The breakpoint specification (location, condition, and expression fields) is semantically immutable, although the field values may change. For example, an agent may update the location line number to reflect the actual line where the breakpoint was set, but this doesn't change the breakpoint semantics.

This means that an agent does not need to check if a breakpoint has changed when it encounters the same breakpoint on a successive call. Moreover, an agent should remember the breakpoints that are completed until the controller removes them from the active list to avoid setting those breakpoints again.

HTTP request


(This URI uses URI Template syntax.)

Path parameters

Parameter name Type Description
debuggeeId string Identifies the debuggee.

Query parameters

Parameter name Type Description
waitToken string A wait token that, if specified, blocks the method call until the list of active breakpoints has changed, or a server selected timeout has expired. The value should be set from the last returned response.
successOnTimeout boolean

If set to true, returns google.rpc.Code.OK status and sets the waitExpired response field to true when the server-selected timeout has expired (recommended).

If set to false, returns google.rpc.Code.ABORTED status when the server-selected timeout has expired (deprecated).

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response for listing active breakpoints.

JSON representation
  "breakpoints": [
  "nextWaitToken": string,
  "waitExpired": boolean,
Field name Type Description
breakpoints[] object(Breakpoint) List of all active breakpoints. The fields id and location are guaranteed to be set on each breakpoint.
nextWaitToken string A wait token that can be used in the next method call to block until the list of breakpoints changes.
waitExpired boolean The waitExpired field is set to true by the server when the request times out and the field successOnTimeout is set to true.


Requires one of the following OAuth scopes:


For more information, see the Auth Guide.

Send feedback about...

Stackdriver Debugger Documentation