Create Or Update Content

This creates new content, or updates existing content.

When you create new content, a cardId will be automatically generated.
To update existing content, a cardId should be provided

You can learn more about how playlists work here.

Required Scope

user:content:manage

Responses

200 OK (Create a card) / 200 OK (Update a card)application/json

cardobject

_idstring

cardIdstring

contentobject

chaptersarray

[items]

configobject

resumeTimeoutnumber

playbackTypestring

createdAtstring

metadataobject

descriptionstring

titlestring

updatedAtstring

userIdstring

{
  "card": {
    "_id": "676016ea43bedbaa54a70549",
    "cardId": "31yYU",
    "content": {
      "chapters": [],
      "config": {
        "resumeTimeout": 2592000
      },
      "playbackType": "linear"
    },
    "createdAt": "2024-12-16T12:02:50.164Z",
    "metadata": {},
    "title": "Testing Podcast",
    "updatedAt": "2024-12-16T12:02:50.164Z",
    "userId": "2kRM9HdDaanNVdLqnjn1d5xFH46Ffmkh@clients"
  }
}

400 Bad Request (Deleted card cannot be restored)application/json

errorobject

codestring

messagestring

{
  "error": {
    "code": "bad-request",
    "message": "Deleted card cannot be restored"
  }
}

Body application/json

cardIdstring

Example73shQ

contentobject

createdAtstring

Example2025-07-03T11:23:22.599Z

deletedboolean

Examplefalse

metadataobject

titlestring

ExampleMY test card

updatedAtstring

Example2025-08-19T12:12:26.894Z

userIdstring

Exampleauth0|6866681815a7c418e911745a

POST

/content

Server URL: https://api.yotoplay.com

Request Body

curl "https://api.yotoplay.com/content"