OCT-103 Gumlet outreach
POST/video/playlist/{playlist_id}/asset

Add assets to a playlist

Adds one or more video assets to a playlist. Provide an asset_list of asset IDs and, optionally, their positions; assets without a position are added at the end of the playlist.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
playlist_idstringrequired

The ID of the playlist to add assets to.

Playlist asset addition request. asset_list is required.

asset_listarray<object>required

An array of asset objects. Each object can specify an asset_id and an optional integer position; an asset without a position is added at the end of the playlist.

4 status codes
200Returns an object with a success value indicating that the addition completed.
successbooleanoptional
Default:true
400Returned when the request is invalid.

One documented failure

  • incorrect_playlist_id

    No playlist with provided id exists.

errorobjectrequired
401Returned when the request has a missing or invalid API key or bearer token.

One documented failure

  • invalid_api_key

    API key supplied with request is invalid

errorobjectrequired
403Returned when the account is unpaid or the authenticated user has insufficient role permissions.

One documented failure

  • unauthorized

    You don't have access to this feature. Please contact your organization owner.

errorobjectrequired

Error handling

A 400 is returned for a bad request. A 401 is returned when the request has a missing or invalid API key or bearer token. A 403 is returned for an unpaid account or insufficient role permissions. The playlist_id path parameter identifies the destination playlist, and asset_list is required.