December 2, 2020 update:
  • The Poly website ( and Poly API will be shut down on June 30, 2021. Uploading of new assets will be disabled two months earlier, on April 30, 2021.
  • Previously uploaded assets will remain available and can be downloaded from until June 30, 2021.

Method: assets.get

Returns detailed information about an asset given its name. PRIVATE assets are returned only if the currently authenticated user (via OAuth token) is the author of the asset.

HTTP request


The URL uses Google API HTTP annotation syntax.

Path parameters



Required. An asset's name in the form assets/{ASSET_ID}.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Asset.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the OAuth 2.0 Overview.