HEheygen
Assets

List Assets

Changed on

Beta: may change with a few days' notice. Lists a workspace member's uploaded assets, newest first, with cursor pagination. username is required during the beta. Pass folder_id to narrow to one folder, or an empty value for the root.

get/v3/assets

Request

  • Base URL
    https://api.heygen.com
  • URL
    https://api.heygen.com/v3/assets
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Query parameters

usernamestring required

Username of the workspace member whose assets to list — the same value as asset items' 'owner' field. Required while this endpoint is in beta; it will become an optional filter in a future release.

limitinteger

Maximum number of assets to return per page (1-100).

tokenstring

Opaque cursor from a previous response's next_token. Omit for the first page.

folder_idstring

Optional folder filter. Omit to list ALL workspace assets across folders. Pass a folder id to list that folder only, or an empty value (folder_id=) for root-level assets (assets not filed into any folder).

Response

Successful response

has_moreboolean

Whether more pages are available

next_tokenstring nullable

Opaque cursor for the next page

Changes