BEbeyondwords
Content

Update content item

Changed on

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}

Request

  • Base URL
    https://api.beyondwords.io/v1
  • URL
    https://api.beyondwords.io/v1/projects/{project_id}/content/{id}
  • Auth
    API key in header X-Api-Key

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' | 'ready' | 'queued' | 'processing' | 'processed' | 'skipped' | 'error'

The current status of the content processing operation. This value will change as the content is processed. ready means the content is prepared and indexed, but audio generation wasn't requested (generate_audio is false). Reaching ready sends a content.ready webhook with the ready state and without media, a preparation failure sends audio.error.

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. Content with generate_audio set to false is always prepared and indexed again on text updates

generate_audioboolean

Whether audio (and dependent video) is generated automatically for the content. Content with false is prepared and indexed without audio generation and has the ready status unless it already has audio. Not applicable to audio_upload content

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)

Changes

  • 994b9853e685Revision changes
    • warning

      added the new ready enum value to the response property for the response status

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      request property / deprecated

    • info

      request property / deprecated

    • info

      request property / deprecated

    • info

      added the optional property to the response with the status

    • info

      response property metadata deprecated