action spinitron_post_spins {
  label: "Log a Spin"
  description: "An endpoint for automation systems to log spins into the spin table."
  provider: spinitron
  method: POST
  path: "/spins"
  encoding: form
  output: {
    type: "object"
    properties: {
      _links: {
        type: "object"
        properties: {
          playlist: {
            type: "object"
            properties: {
              href: {
                type: "string"
              }
            }
          }
          self: {
            type: "object"
            additionalProperties: true
          }
        }
      }
      artist: {
        type: "string"
      }
      "artist-custom": {
        type: "string"
        description: "Station-specific custom field relating to the song's artist"
      }
      "catalog-number": {
        type: "string"
        description: "Reference number in the record label's catalog"
      }
      classical: {
        type: "boolean"
        description: "Is the track's metadata schema \"classical\" rather than \"popular\"?"
      }
      composer: {
        type: "string"
      }
      conductor: {
        type: "string"
        description: "For classical music, conducor of the ensemble"
      }
      duration: {
        type: "integer"
        description: "Duration in seconds"
      }
      end: {
        type: "string"
        format: "date-time"
        description: "UTC datetime ISO-8601"
      }
      ensemble: {
        type: "string"
        description: "For classical music, orchestra, performing ensemble, choir, etc."
      }
      genre: {
        type: "string"
      }
      id: {
        type: "integer"
      }
      image: {
        type: "string"
        format: "url"
        description: "Cover art"
      }
      isrc: {
        type: "string"
      }
      iswc: {
        type: "string"
      }
      label: {
        type: "string"
        description: "Record label, i.e. publisher of the sound recording"
      }
      "label-custom": {
        type: "string"
        description: "Station-specific custom field relating to the record label"
      }
      local: {
        type: "boolean"
        description: "Is the artist local to the station?"
      }
      medium: {
        type: "string"
        description: "Media format in which the sound recording was reased"
      }
      new: {
        type: "boolean"
        description: "Is this a recent release?"
      }
      note: {
        type: "string"
        description: "HTML-formatted DJ annotation of the spin, can include images etc."
      }
      performers: {
        type: "string"
        description: "For classical music, featured performing artists, e.g. soloists"
      }
      playlist_id: {
        type: "integer"
      }
      release: {
        type: "string"
      }
      "release-custom": {
        type: "string"
        description: "Station-specific custom field relating to the release"
      }
      released: {
        type: "integer"
        description: "Year of initial release"
      }
      request: {
        type: "boolean"
        description: "Was the spin requested by a listener?"
      }
      song: {
        type: "string"
        description: "Title of the song or track"
      }
      start: {
        type: "string"
        format: "date-time"
        description: "UTC datetime ISO-8601"
      }
      timezone: {
        type: "string"
        description: "Station's time zone"
      }
      upc: {
        type: "string"
        description: "Universal Product Code of the release"
      }
      va: {
        type: "boolean"
        description: "Is it a \"Various Artists\" release?"
      }
      work: {
        type: "string"
        description: "For classical music, the main compositional work the track (see `song` field) belongs to"
      }
    }
  }
}