Welcome to the Google Home Developer Center, the new destination for learning how to develop smart home actions. Note: You'll continue building actions in the Actions console.

Method: agentUsers.delete

Unlinks the given third-party user from your smart home Action. All data related to this user will be deleted.

For more details on how users link their accounts, see fulfillment and authentication.

The third-party user's identity is passed in via the agentUserId (see DeleteAgentUserRequest). This request must be authorized using service account credentials from your Actions console project.

HTTP request

DELETE https://homegraph.googleapis.com/v1/{agentUserId=agentUsers/**}

The URL uses gRPC Transcoding syntax.

Path parameters



Required. Third-party user ID.

Query parameters



Request ID used for debugging.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/homegraph

For more information, see the OAuth 2.0 Overview.