v1

latestOpenAPI 3.0.42026-08-068161,1253.1 MB
Assets

Retrieve specific asset metadata. Include the `readMask` parameter for additional asset metadata.

Retrieve specific asset metadata.

get/assets/v1/assets/{assetId}

Path parameters

assetIdstring required

The unique identifier of the asset.

Query parameters

readMaskstring

Asset metadata fields to retrieve, including the description, display name, icon, social links, and previews. Examples: description%2CdisplayName, previews%2CtwitchSocialLink.

Response

Asset resource retrieved successfully.

assetTypestring enum

The asset type. Required for Create Asset.

assetIdinteger

The unique identifier of the asset. Required for Update Asset.

descriptionstring

The description of the asset. Limit to 1000 characters. Required for Create Asset.

displayNamestring

Display name of the asset. Required for Create Asset.

pathstring

The returned resource path of the asset. Format: assets/{assetId}. Example: assets/2205400862.

revisionIdstring

Revision ID of the asset. Equivalent to versionNumber. Every change of the asset automatically commits a new version. The format is an integer string. Example: 1.

revisionCreateTimestring date-time

The creation timestamp of the current revision.

iconstring

The resource path for the icon.

state'Unspecified' | 'Active' | 'Archived'

Whether the asset is active or archived. Unspecified isn't used.