action prss_post_api_v2_pieces {
  label: "Create a new piece."
  provider: prss
  method: POST
  path: "/api/v2/pieces"
  encoding: json
  input: {
    type: "object"
    description: "The metadata about a \"piece\" which may be a story, song, report, etc."
    required: ["episodeId", "relativeEndTime", "relativeStartTime", "title"]
    properties: {
      contributor: {
        type: "string"
        description: "The artist or contributor name."
      }
      createdDate: {
        type: "string"
        format: "date-time"
        description: "The date the piece was created. Generated at creation."
      }
      description: {
        type: "string"
        description: "The short description of the piece."
      }
      episodeId: {
        type: "integer"
        format: "int64"
        description: "The ID of the episode that owns the piece."
      }
      fullDescription: {
        type: "string"
        description: "The long description of the piece."
      }
      id: {
        type: "integer"
        format: "int64"
        description: "The unique ID of the piece. Generated at creation."
      }
      imageCdDriveUri: {
        type: "string"
        description: "The URI to the piece image content in CD Drive. Format should be 'cddrive:id:{value}' or 'cddrive://{path}'. This property is only used on modification and is not returned."
      }
      imageFileName: {
        type: "string"
        description: "The name of the piece image file. Generated at creation."
      }
      imageFileSize: {
        type: "integer"
        format: "int64"
        description: "The size of the piece image file in bytes. Generated at creation."
      }
      imageOriginalFileName: {
        type: "string"
        description: "The user's original name of the piece image file."
      }
      lastModifiedDate: {
        type: "string"
        format: "date-time"
        description: "The date the piece was last modified/updated. Automatically updated on any write operation."
      }
      relativeEndTime: {
        type: "integer"
        format: "int32"
        description: "Seconds relative to the start of the episode."
      }
      relativeStartTime: {
        type: "integer"
        format: "int32"
        description: "Seconds relative to the start of the episode."
      }
      segmentNumber: {
        type: "integer"
        format: "int32"
        description: "The number of the segment that this piece is in, starting with 1. This is an optional field but it can be used to provide more detail by linking the piece to a specific audio segment."
      }
      title: {
        type: "string"
        description: "The human readable title of the piece that is normally displayed on an end user's device."
      }
    }
  }
  output: {
    type: "object"
    description: "The metadata about a \"piece\" which may be a story, song, report, etc."
    required: ["episodeId", "relativeEndTime", "relativeStartTime", "title"]
    properties: {
      contributor: {
        type: "string"
        description: "The artist or contributor name."
      }
      createdDate: {
        type: "string"
        format: "date-time"
        description: "The date the piece was created. Generated at creation."
      }
      description: {
        type: "string"
        description: "The short description of the piece."
      }
      episodeId: {
        type: "integer"
        format: "int64"
        description: "The ID of the episode that owns the piece."
      }
      fullDescription: {
        type: "string"
        description: "The long description of the piece."
      }
      id: {
        type: "integer"
        format: "int64"
        description: "The unique ID of the piece. Generated at creation."
      }
      imageCdDriveUri: {
        type: "string"
        description: "The URI to the piece image content in CD Drive. Format should be 'cddrive:id:{value}' or 'cddrive://{path}'. This property is only used on modification and is not returned."
      }
      imageFileName: {
        type: "string"
        description: "The name of the piece image file. Generated at creation."
      }
      imageFileSize: {
        type: "integer"
        format: "int64"
        description: "The size of the piece image file in bytes. Generated at creation."
      }
      imageOriginalFileName: {
        type: "string"
        description: "The user's original name of the piece image file."
      }
      lastModifiedDate: {
        type: "string"
        format: "date-time"
        description: "The date the piece was last modified/updated. Automatically updated on any write operation."
      }
      relativeEndTime: {
        type: "integer"
        format: "int32"
        description: "Seconds relative to the start of the episode."
      }
      relativeStartTime: {
        type: "integer"
        format: "int32"
        description: "Seconds relative to the start of the episode."
      }
      segmentNumber: {
        type: "integer"
        format: "int32"
        description: "The number of the segment that this piece is in, starting with 1. This is an optional field but it can be used to provide more detail by linking the piece to a specific audio segment."
      }
      title: {
        type: "string"
        description: "The human readable title of the piece that is normally displayed on an end user's device."
      }
    }
  }
}