API Reference

Read Media Item

GET/api/v2/mediasets/{mediaSetRid}/items/{mediaItemRid}/content

Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Gets the content of a media item.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:mediasets-read.

Path parameters

mediaSetRid

string

The Resource Identifier (RID) of a Media Set in Foundry.

mediaItemRid

string

The Resource Identifier (RID) of an individual Media Item within a Media Set in Foundry.

preview

boolean

optional

A boolean flag that, when set to true, enables the use of beta features in preview mode.

body

string

The content stream.

Copied!

curl \
	-H "Authorization: Bearer $TOKEN" \
	"https://$HOSTNAME/api/v2/mediasets/{mediaSetRid}/items/{mediaItemRid}/content?preview=true"