We want to hear your thoughts on the Google Smart Home platform. Join a user study and receive a gift for your input. Click here to sign up.

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 will be empty.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.