action prss_get_api_v2_segments_id {
  label: "Returns the segment matching the given ID."
  provider: prss
  method: GET
  path: "/api/v2/segments/{id}"
  encoding: json
  output: {
    type: "object"
    description: "An audio segment in an episode."
    required: ["episodeId", "segmentNumber"]
    properties: {
      channels: {
        type: "integer"
        format: "int32"
        description: "The number of audio channels in the segment. Generated at creation."
      }
      createdDate: {
        type: "string"
        format: "date-time"
        description: "The date the segment was created. Generated at creation."
      }
      episodeId: {
        type: "integer"
        format: "int64"
        description: "The ID of the episode that owns the segment."
      }
      fileName: {
        type: "string"
        description: "The name of the audio content file. Generated at creation."
      }
      fileSize: {
        type: "integer"
        format: "int64"
        description: "The size of the audio content file in bytes. Generated at creation."
      }
      id: {
        type: "integer"
        format: "int64"
        description: "The unique ID of the segment. Generated at creation."
      }
      inCue: {
        type: "string"
        description: "The in-cue copy that signals the start of the segment to a board operator."
      }
      lastModifiedDate: {
        type: "string"
        format: "date-time"
        description: "The date the segment was last modified/updated. Automatically updated on any write operation."
      }
      length: {
        type: "integer"
        format: "int32"
        description: "The length (duration) of the segment in seconds."
      }
      originalFileName: {
        type: "string"
        description: "The original name of the audio content file."
      }
      outCue: {
        type: "string"
        description: "The out-cue copy that signals the end of the segment to a board operator."
      }
      segmentNumber: {
        type: "integer"
        format: "int32"
        description: "The number of the segment in the episode, starting with 1."
      }
    }
  }
}