Yoto Developers
Search K

Appearance

get content​

GET
/content/{contentId}

Returns a piece of content. A user can view a piece of content if:

  • They own the content

  • If they have an appropriate content viewer/editor role

If a user is not allowed to view the content, a 404 is returned.

Time zones

Providing a timezone param will result in returning a piece of content with chapters where:

  • availableFrom is set to a date up to and including today in the provided time zone

  • availableFrom is null or absent

Currently this only applies to podcast content; providing the timezone param for non-podcast content will not affect the chapters returned.

Valid timezone identifiers can be found here. A 400 response will be returned if an invalid time zone is provided. If no timezone param is provided, then chapters are returned based on the UTC timezone.

Authorizations​

bearerAuth
TypeHTTP (bearer)

Parameters​

Query Parameters

timezone

Timezone identifier

Typestring
ExamplePacific/Auckland
signingType

The type of playable signed URLs returned. Use with playable.

Typestring
Examples3
playable

Return playable signed URLs

Typestring
Exampletrue

Responses​

200 OK
application/json
JSON
{
"card": {
"cardId": "iMG7o",
"content": {
"activity": "yoto_Player",
"chapters": [
],
"config": {
},
"editSettings": {
"autoOverlayLabels": "disabled",
"editKeys": false,
"transcodeAudioUploads": true
},
"version": "1"
},
"createdAt": "2021-05-07T14:08:26.435Z",
"creatorEmail": "theresa.may.1@yotoplay.com",
"deleted": false,
"metadata": {
"category": "none",
"cover": {
},
"media": {
"duration": 1419,
"fileSize": 0,
"hasStreams": false
}
},
"shareLimit": 0,
"shareLinkCreatedAt": "2022-03-03T00:00:00.000Z",
"slug": "5VmJm1wxphhSh0by74XQbw",
"title": "something blah",
"updatedAt": "2023-06-22T10:16:53.717Z",
"userId": "auth0|65afcb79a4f5ae5550e6e63a"
}
}

Playground​

Authorization
Variables
Key
Value

Samples​