Content object

A content item belongs to a project and is returned by List, Create, Get, and Update content endpoints. See Processing types for how type affects what you send in requests. For syndication, check is_copy to distinguish originals from reused audio.

Properties

Property	Type	Description
`id`	string	Unique UUID for the object.
`status`	string	Processing state: `draft`, `queued`, `processing`, `processed`, `skipped`, or `error`.
`type`	string	`auto_segment`, `manual_segment`, or `audio_upload`.
`title`	string	Content title.
`summary`	string	Content summary.
`body`	string	Content body.
`source_id`	string	External identifier from your CMS or feed.
`source_url`	string	Public URL of the source article.
`author`	string	Content author.
`image_url`	string	Feature image URL.
`metadata`	object	Arbitrary key-value metadata (for example, `{"category": "sport"}`).
`is_copy`	boolean	`true` when audio is reused from another project via syndication.
`audio`	array	Generated audio files for the full content item.
`audio.id`	integer	Audio object identifier.
`audio.content_type`	string	MIME type of the audio file.
`audio.url`	string	URL of the generated audio file.
`audio.duration`	integer	Duration in milliseconds.
`video`	array	Generated video files for the full content item.
`segments`	array	Segments in the content item. Use `?segments=full` on GET to populate.
`segments.id`	integer	Segment identifier.
`segments.marker`	string	Marker for segment-level playback.
`segments.section`	string	`title`, `summary`, or `body`.
`segments.content_type`	string	`text`, `audio`, `image`, or `video`.
`segments.text`	string	Plain text when `content_type` is `text`.
`segments.audio_url`	string	Audio URL when `content_type` is `audio`.
`segments.image_url`	string	Image URL when `content_type` is `image`.
`segments.video_url`	string	Video URL when `content_type` is `video`.
`segments.video_settings`	object	Settings for video segments.
`segments.video_settings.plays_in_background`	boolean	When `true`, the clip plays under narration (timed like an image and looping as needed) instead of as a standalone scene. Defaults to `false`.
`segments.start_time`	integer	Start time in milliseconds.
`segments.duration`	integer	Duration in milliseconds.
`published`	boolean	Whether the item appears in players and feeds.
`publish_date`	string	Publish or scheduled publish time (ISO 8601).
`ads_enabled`	boolean	Whether ads play for this item in players.
`auto_segment_updates_enabled`	boolean	Regenerate audio when `title`, `summary`, or `body` changes (`auto_segment` only).
`created`	string	Creation time (ISO 8601).
`updated`	string	Last update time (ISO 8601).

Getting started

Content

Extraction

Pronunciation settings

Script settings

Video settings

Background music settings

Voices

Distribution

Integrations

Analytics

Monetization

Organization

Properties

​Properties

Properties