@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api ART19 Content API Documentation
@base https://art19.com/
@version 1.0.0
@auth ApiKey Authorization in header
@endpoints 92
@hint download_for_search
@toc classifications(2), classification_inclusions(2), credits(5), episodes(12), episode_versions(5), feeds(6), feed_items(7), genres(2), series(13), images(4), languages(2), marker_points(5), marker_point_content_rules(5), media_assets(2), media_ratings(2), seasons(9), networks(4), people(5)

@group classifications
@endpoint GET /classifications
@optional {ids[]: any, page[number]: any, page[size]: any, type: any, q: any, is_country: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint GET /classifications/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endgroup

@group classification_inclusions
@endpoint GET /classification_inclusions
@optional {ids[]: any, page[number]: any, page[size]: any, classification_id: any, classification_type: any, classified_id: any, classified_type: any, q: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint GET /classification_inclusions/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endgroup

@group credits
@endpoint GET /credits
@optional {ids[]: any, page[number]: any, page[size]: any, creditable_id: any, creditable_type: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /credits
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint DELETE /credits/{id}
@returns(204)
@errors {401, 403, 406, 429, 507}

@endpoint GET /credits/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endpoint PATCH /credits/{id}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endgroup

@group episodes
@endpoint GET /episodes
@required {page[number]: any, page[size]: any}
@optional {ids[]: any, has_downloads: any, included_in_inventory_calendar: any, itunes_type: any, month: any, published: any, q: any, released_after: any, released_before: any, rss: any, season_id: any, series_id: any, sort: any, year: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /episodes
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint DELETE /episodes/{id}
@returns(204)
@errors {401, 403, 406, 429, 507}

@endpoint GET /episodes/{id}
@required {id: any}
@optional {include: any}
@returns(200)
@errors {400, 401, 403, 404, 406, 429}

@endpoint PATCH /episodes/{id}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint GET /episodes/{id}.jpeg
@required {id: any}
@optional {style: any}
@errors {302, 401, 403, 404, 406}

@endpoint GET /episodes/{id}.mp3
@required {id: any}
@optional {type: any}
@errors {302, 401, 403, 404, 406}

@endpoint GET /episodes/{id}/next_sibling
@required {id: any}
@optional {rss: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endpoint GET /episodes/{id}/previous_sibling
@required {id: any}
@optional {rss: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endgroup

@group episode_versions
@endpoint GET /episode_versions
@optional {ids[]: any, episode_id: any, feed_item_id: any, page[number]: any, page[size]: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /episode_versions
@required {body: map}
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint DELETE /episode_versions/{id}
@required {id: any}
@returns(204)
@errors {401, 403, 406, 429, 507}

@endpoint GET /episode_versions/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endpoint PATCH /episode_versions/{id}
@required {body: map}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endgroup

@group feeds
@endpoint GET /feeds
@required {page[number]: any, page[size]: any}
@optional {ids[]: any, primary: any, series_id: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /feeds
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint DELETE /feeds/{id}
@returns(204)
@errors {401, 403, 406, 429, 507}

@endpoint GET /feeds/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endpoint PATCH /feeds/{id}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint GET /feeds/{id}.jpeg
@required {id: any}
@optional {style: any}
@errors {302, 401, 403, 404, 406}

@endgroup

@group feed_items
@endpoint GET /feed_items
@required {page[number]: any, page[size]: any}
@optional {ids[]: any, episode_id: any, feed_id: any, itunes_type: any, published: any, q: any, released_after: any, released_before: any, series_id: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /feed_items
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint DELETE /feed_items/{id}
@returns(204)
@errors {401, 403, 406, 429, 507}

@endpoint GET /feed_items/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endpoint PATCH /feed_items/{id}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint GET /feed_items/{id}.jpeg
@required {id: any}
@optional {style: any}
@errors {302, 401, 403, 404, 406}

@endpoint GET /feed_items/{id}.mp3
@required {id: any}
@optional {type: any}
@errors {302, 401, 403, 404, 406}

@endgroup

@group genres
@endpoint GET /genres
@required {page[number]: any, page[size]: any}
@optional {ids[]: any, q: any, series_id: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint GET /genres/{id}
@required {id: any}
@optional {include: any}
@returns(200)
@errors {400, 401, 403, 404, 406, 429}

@endgroup

@group series
@endpoint DELETE /series/{id}/relationships/genres
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endpoint GET /series/{id}/relationships/genres
@required {id: any, page[number]: any, page[size]: any}
@returns(200)
@errors {400}

@endpoint POST /series/{id}/relationships/genres
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endgroup

@group images
@endpoint GET /images
@required {ids[]: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /images
@required {body: map}
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint DELETE /images/{id}
@required {id: any}
@returns(204)
@errors {401, 403, 406, 429, 507}

@endpoint GET /images/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endgroup

@group languages
@endpoint GET /languages
@required {page[number]: any, page[size]: any}
@optional {ids[]: any, q: any, series_id: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint GET /languages/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endgroup

@group series
@endpoint DELETE /series/{id}/relationships/languages
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endpoint GET /series/{id}/relationships/languages
@required {id: any, page[number]: any, page[size]: any}
@returns(200)
@errors {400}

@endpoint POST /series/{id}/relationships/languages
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endgroup

@group marker_points
@endpoint GET /marker_points
@required {page[number]: any, page[size]: any}
@optional {ids[]: any, episode_id: any, episode_version_id: any, season_id: any, series_id: any, type: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /marker_points
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint DELETE /marker_points/{id}
@required {id: any}
@returns(204)
@errors {401, 403, 406, 429, 507}

@endpoint GET /marker_points/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endpoint PATCH /marker_points/{id}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endgroup

@group marker_point_content_rules
@endpoint GET /marker_point_content_rules
@required {page[number]: any, page[size]: any}
@optional {ids[]: any, marker_point_id: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /marker_point_content_rules
@required {body: map}
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint DELETE /marker_point_content_rules/{id}
@required {id: any}
@returns(204)
@errors {401, 403, 406, 429, 507}

@endpoint GET /marker_point_content_rules/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endpoint PATCH /marker_point_content_rules/{id}
@required {body: map}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endgroup

@group media_assets
@endpoint GET /media_assets
@required {ids[]: any}
@optional {attachment_id: any, attachment_type: any, style: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint GET /media_assets/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endgroup

@group media_ratings
@endpoint GET /media_ratings
@required {page[number]: any, page[size]: any}
@optional {ids[]: any, q: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint GET /media_ratings/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endgroup

@group episodes
@endpoint DELETE /episodes/{id}/relationships/media_ratings
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endpoint GET /episodes/{id}/relationships/media_ratings
@required {id: any, page[number]: any, page[size]: any}
@returns(200)
@errors {400}

@endpoint POST /episodes/{id}/relationships/media_ratings
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endgroup

@group seasons
@endpoint DELETE /seasons/{id}/relationships/media_ratings
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endpoint GET /seasons/{id}/relationships/media_ratings
@required {id: any, page[number]: any, page[size]: any}
@returns(200)
@errors {400}

@endpoint POST /seasons/{id}/relationships/media_ratings
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endgroup

@group series
@endpoint DELETE /series/{id}/relationships/media_ratings
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endpoint GET /series/{id}/relationships/media_ratings
@required {id: any, page[number]: any, page[size]: any}
@returns(200)
@errors {400}

@endpoint POST /series/{id}/relationships/media_ratings
@required {id: any, body: any}
@returns(204)
@errors {400, 422}

@endgroup

@group networks
@endpoint GET /networks
@optional {ids[]: any, page[number]: any, page[size]: any, q: any, ad_rep_account_id: any, ad_deal_status: any, parent_id: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint GET /networks/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endpoint PATCH /networks/{id}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint GET /networks/{id}.jpeg
@required {id: any}
@optional {style: any}
@errors {302, 401, 403, 404, 406}

@endgroup

@group people
@endpoint GET /people
@optional {ids[]: any, page[number]: any, page[size]: any, q: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /people
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint GET /people/{id}
@required {id: any}
@returns(200)
@errors {401, 403, 404, 406, 429}

@endpoint PATCH /people/{id}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint GET /people/{id}.jpeg
@required {id: any}
@optional {style: any}
@errors {302, 401, 403, 404, 406}

@endgroup

@group seasons
@endpoint GET /seasons
@optional {ids[]: any, page[number]: any, page[size]: any, series_id: any, q: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint POST /seasons
@returns(201)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint DELETE /seasons/{id}
@returns(204)
@errors {401, 403, 406, 429, 507}

@endpoint GET /seasons/{id}
@required {id: any}
@optional {include: any}
@returns(200)
@errors {400, 401, 403, 404, 406, 429}

@endpoint PATCH /seasons/{id}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint GET /seasons/{id}.jpeg
@required {id: any}
@optional {style: any}
@errors {302, 401, 403, 404, 406}

@endgroup

@group series
@endpoint GET /series
@required {page[number]: any, page[size]: any}
@optional {ids[]: any, ad_rep_account_id: any, network_id: any, parent_network_id: any, q: any, sort: any}
@returns(200)
@errors {400, 401, 403, 406, 429}

@endpoint GET /series/{id}
@required {id: any}
@optional {include: any}
@returns(200)
@errors {400, 401, 403, 404, 406, 429}

@endpoint PATCH /series/{id}
@returns(200)
@errors {401, 403, 406, 415, 422, 429, 507}

@endpoint GET /series/{id}.jpeg
@required {id: any}
@optional {style: any}
@errors {302, 401, 403, 404, 406}

@endgroup

@end