Content

A content item as it appears in GET /contents. The single-content view returns a different, richer shape — see ContentDetail.

idstring<uuid>

titlestring

descriptionstring | nullnullable

upload_date(string | null)<date-time>nullable

creation_datestring<date-time>

updated_atstring<date-time>

statusContentStatus

Lifecycle of a content item.

Terminal states are UPLOADED and the four FAILED_* values; everything else means work is still in flight.

READY_FOR_UPLOAD is deprecated — it was split into UPLOADING (dispatched) and VIDEO_PROCESSED (rendered but parked with no accounts selected), and only appears on rows written before that change.

Possible values: [NEW, PROCESSING, PROCESSING_AUDIO, AUDIO_PROCESSED, PROCESSING_VIDEO, VIDEO_PROCESSED, UPLOADING, READY_FOR_UPLOAD, UPLOADED, FAILED_AUDIO, FAILED_VIDEO, FAILED_UPLOAD, FAILED]

last_errorstring | nullnullable

Set when status is one of the FAILED_* values.

video_urlstring | nullnullable

Signed URL for the rendered video. Time-limited — fetch it fresh rather than storing it. Null until the video has rendered.

thumbnail_urlstring | nullnullable

Signed URL for the thumbnail. Time-limited.

published_urlstring | nullnullable

Where to watch this on the platform. Null until an upload actually succeeded.

published_platformstring | nullnullable

Possible values: [YouTube, TikTok, Instagram, null]

persona object

idstring | nullnullable

namestring | nullnullable

Content

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "string",
  "description": "string",
  "upload_date": "2024-07-29T15:51:28.071Z",
  "creation_date": "2024-07-29T15:51:28.071Z",
  "updated_at": "2024-07-29T15:51:28.071Z",
  "status": "NEW",
  "last_error": "string",
  "video_url": "string",
  "thumbnail_url": "string",
  "published_url": "string",
  "published_platform": "YouTube",
  "persona": {
    "id": "string",
    "name": "string"
  }
}