---
title: "POST /v1/devices:requestSync"
method: POST
path: "/v1/devices:requestSync"
tags: ["devices"]
---

# POST /v1/devices:requestSync

`POST /v1/devices:requestSync`

Requests Google to send an `action.devices.SYNC` [intent](https://developers.home.google.com/cloud-to-cloud/intents/sync) to your smart home Action to update device metadata for the given user. The third-party user's identity is passed via the `agent_user_id` (see RequestSyncDevicesRequest). This request must be authorized using service account credentials from your Actions console project.

## Request body

- RequestSyncDevicesRequest — Request type for the [`RequestSyncDevices`](#google.home.graph.v1.HomeGraphApiService.RequestSyncDevices) call.
  - `async` boolean — Optional. If set, the request will be added to a queue and a response will be returned immediately. This enables concurrent requests for the given `agent_user_id`, but the caller will not receive any error responses.
  - `agentUserId` string — Required. Third-party user ID.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/homegraph.md) · [All operations](https://skmtc.net/google/apis/homegraph/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/homegraph/versions/28c601cbc091/schema)