PRprss
Segments

Creates a new segment.

post/api/v2/segments

Request

  • Base URL
    https://contentdepot.prss.org (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Authorization code: /api/oauth2/authorize
    Token URL: /api/oauth2/token scopes: cd:full

Request body application/x-www-form-urlencoded

episodeIdinteger required

The ID of the episode that owns the segment.

segmentNumberinteger required

The segment number of the segment.

cdDriveUristring required

The URI to the segment content in CD Drive. Format should be 'cddrive:id:{value}' or 'cddrive://{path}'.

inCuestring

The incue for the segment. Defaults to the subscription hour segment incue.

outCuestring

The outcue for the segment. Defaults to the subscription hour segment outcue.

Response

The created segment with fields populated.

idinteger

The unique ID of the segment. Generated at creation.

episodeIdinteger required

The ID of the episode that owns the segment.

segmentNumberinteger required

The number of the segment in the episode, starting with 1.

inCuestring

The in-cue copy that signals the start of the segment to a board operator.

outCuestring

The out-cue copy that signals the end of the segment to a board operator.

createdDatestring date-time

The date the segment was created in ISO 8601 format. Generated at creation.

lastModifiedDatestring date-time

The date the segment was last modified/updated in ISO 8601 format. Automatically updated on any write operation.

lengthinteger

The length (duration) of the segment in seconds.

channelsinteger

The number of audio channels in the segment. Generated at creation.

fileSizeinteger

The size of the audio content file in bytes. Generated at creation.

fileNamestring

The name of the audio content file. Generated at creation.

originalFileNamestring

The original name of the audio content file.

Changes

No recorded changes to this operation across all 3 revisions of this API.