Sign in

v1

latestOpenAPI 3.0.12026-07-2210997354.2 KB
Content

Update content item

Updates a content item in your project.

Segment replace semantics: When you include a segments array, it becomes the new complete set of segments. Segments with an id are kept or updated; segments without an id are added; segments omitted from the array are deleted.

Regeneration: Only changed segments are re-synthesized — unchanged segment audio is reused. A PUT that changes segments triggers regeneration automatically. Use POST /content/{id}/regenerate only when you need to regenerate without segment changes (for example, after updating voice or preprocessing settings).

put/projects/{project_id}/content/{id}

Query parameters

segmentsstring

The level of detail to show for segments in the response: 'none', 'partial' or 'full'

Request body

OR
OR

Response

successful

idstring nullable

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

status'draft' | 'queued' | 'processing' | 'processed' | 'skipped' | 'error'

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)