action listennotes_get_playlists {
  label: "Fetch a list of your playlists."
  description: "This endpoint returns same data as listennotes.com/listen under your account.\nYou can use the **page** parameter to do pagination and fetch more playlists.\n"
  provider: listennotes
  method: GET
  path: "/playlists"
  encoding: json
  input: {
    type: "object"
    properties: {
      page: {
        type: "integer"
      }
      sort: {
        type: "string"
        enum: ["recent_added_first", "oldest_added_first", "name_a_to_z", "name_z_to_a"]
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      has_next: {
        type: "boolean"
      }
      has_previous: {
        type: "boolean"
      }
      next_page_number: {
        type: "integer"
      }
      page_number: {
        type: "integer"
      }
      playlists: {
        type: "array"
        items: {
          type: "object"
          description: "A playlist"
          properties: {
            description: {
              type: "string"
              description: "Playlist description."
            }
            episode_count: {
              type: "integer"
              description: "The number of episodes (including custom audio) in this playlist."
            }
            id: {
              type: "string"
              description: "A 11-character playlist id, which can be used to further fetch detailed playlist metadata via `GET /playlists/{id}`."
            }
            image: {
              type: "string"
              description: "High resolution image url of the playlist."
            }
            last_timestamp_ms: {
              type: "integer"
              description: "Passed to the **last_timestamp_ms** parameter of `GET /playlists/{id}` to paginate through items of that playlist.\n"
            }
            listennotes_url: {
              type: "string"
              description: "The url of this playlist on ListenNotes.com."
            }
            name: {
              type: "string"
              description: "Playlist name."
            }
            podcast_count: {
              type: "integer"
              description: "The number of podcasts in this playlist."
            }
            thumbnail: {
              type: "string"
              description: "Low resolution image url of the playlist."
            }
            total_audio_length_sec: {
              type: "integer"
              description: "Total audio length of all episodes in this playlist, in seconds."
            }
            visibility: {
              type: "string"
              description: "Visibility of this playlist."
              enum: ["public", "unlisted", "private"]
            }
          }
        }
      }
      previous_page_number: {
        type: "integer"
      }
      total: {
        type: "integer"
      }
    }
  }
}