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.

Poly API

The Poly API provides read access to assets hosted on to all, and upload access to for whitelisted accounts.


All URIs below are relative to

This service provides the following discovery document:

REST Resource: v1.assets

get GET /v1/{name=assets/*}
Returns detailed information about an asset given its name.
list GET /v1/assets
Lists all public, remixable assets.
startImport POST /v1/assets:startImport
Begin the import of an asset that the user has already uploaded via our upload endpoint.

REST Resource: v1.operations

cancel POST /v1/{name=operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1/{name=operations/**}
Deletes a long-running operation.
list GET /v1/{name}
Lists operations that match the specified filter in the request.

REST Resource: v1.operations.poly.assetimport

get GET /v1/{name=operations/poly/assetimport/*}
Gets the latest state of a long-running operation.

REST Resource: v1.users.assets

list GET /v1/{name=users/*}/assets
Lists assets authored by the given user.

REST Resource: v1.users.likedassets

list GET /v1/{name=users/*}/likedassets
Lists assets that the user has liked.