v1

latestOpenAPI 3.0.12026-07-2210997354.2 KB

Content

List content items

Lists content items within a project.

get/projects/{project_id}/content

Query parameters

filter[id]string

filter by content id

filter[source_id]string

filter by content source id

filter[source_url]string

filter by content source url

filter[title]string

filter by content title

filter[body]string

filter by content body

filter[published]boolean

filter by content published status

filter[video_published]boolean

filter by content video published status

filter[statuses][]string[]

filter by content statuses

filter[created][from]string date-time

filter by created time from (ISO 8601)

filter[created][to]string date-time

filter by created time to (ISO 8601)

filter[updated][from]string date-time

filter by updated time from (ISO 8601)

filter[updated][to]string date-time

filter by updated time to (ISO 8601)

filter[publish_date][from]string date-time

filter by publish date from (ISO 8601)

filter[publish_date][to]string date-time

filter by publish date to (ISO 8601)

pagination[limit]integer

'limit' sets the number of results to return in each page.

pagination[offset]integer

'offset' sets the first position to return from the results of the query. The default is 0, which starts the page at the first result.

order[by]'created' | 'publish_date' | 'duration' | 'published' | 'status'

This is used to order content

order[dir]'asc' | 'desc'

This is used to order analytics in the ascending or descending order

Response

idstring nullable

Unique identifier for the content. Can be either a UUID or an externally provided source_id

The current status of the content processing operation. This value will change as the content is processed.

type'auto_segment' | 'manual_segment' | 'audio_upload'

The content type. Possible values are auto_segment, manual_segment or audio_upload

titlestring nullable

The content title

summarystring nullable

The content summary

bodystring nullable

The content body

title_enabledboolean

The flag to enable title segments in audio

body_enabledboolean

The flag to enable body segments in audio

summary_enabledboolean

The flag to enable summary audio

summary_title_enabledboolean

The flag to include title text and audio segments in summaries

source_idstring nullable

The externally-provided source identifier of the content

source_urlstring nullable

The URL that contains the source content

authorstring nullable

The author of the content

tagsstring[]

Arbitrary tags associated with the content, used for playlist filtering

image_urlstring nullable

The feature image URL of the content

metadataobject nullable

The arbitrary metadata associated with content

publishedboolean

Whether the content will appear in the BeyondWords players and podcast feeds

video_publishedboolean

Whether the content will appear in the BeyondWords video players and podcast video feeds

publish_datestring nullable

Time at which the content was published or is scheduled to be published (ISO 8601)

ads_enabledboolean

Whether adverts will play for this content in the BeyondWords players

ai_summary_promptstring nullable

The last used AI prompt for summary generation

ai_summary_updates_enabledboolean

Whether the summary segments will be regenerated when the text content is updated

auto_segment_updates_enabledboolean

Whether the media files will be regenerated when the text content is updated with auto_segment

languagestring nullable

The default language of the content

createdstring date-time

Time at which the object was created (ISO 8601)

updatedstring date-time

Time at which the object was updated (ISO 8601)