{"files":{"SKILL.md":"---\nname: art19-content-api-documentation\ndescription: \"ART19 Content API Documentation API skill. Use when working with ART19 Content API Documentation for classifications, classification_inclusions, credits. Covers 92 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# ART19 Content API Documentation\nAPI version: 1.0.0\n\n## Auth\nApiKey Authorization in header\n\n## Base URL\nhttps://art19.com/\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /classifications -- get a list of classifications\n3. POST /credits -- create first credit\n\n## Endpoints\n92 endpoints across 18 groups. See references/api-spec.lap for full details.\n\n### Classifications\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /classifications | Get a list of classifications |\n| GET | /classifications/{id} | Get a specific classification |\n\n### Classification_inclusions\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /classification_inclusions | Get ClassificationInclusion records |\n| GET | /classification_inclusions/{id} | Get a specific classification inclusion |\n\n### Credits\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /credits | Get a list of credits |\n| POST | /credits | Create a new credit |\n| DELETE | /credits/{id} | Delete a specific credit |\n| GET | /credits/{id} | Get a specific credit |\n| PATCH | /credits/{id} | Update a specific credit |\n\n### Episodes\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /episodes | Get a list of episodes |\n| POST | /episodes | Create a new episode |\n| DELETE | /episodes/{id} | Delete a specific episode |\n| GET | /episodes/{id} | Get a specific episode |\n| PATCH | /episodes/{id} | Update a specific episode |\n| GET | /episodes/{id}.jpeg | Get image file |\n| GET | /episodes/{id}.mp3 | Get audio file |\n| GET | /episodes/{id}/next_sibling | Get the episode released right after the specified one |\n| GET | /episodes/{id}/previous_sibling | Get the episode released right before the specified one |\n| DELETE | /episodes/{id}/relationships/media_ratings | Remove media_rating associations from a episode |\n| GET | /episodes/{id}/relationships/media_ratings | Get media_ratings for a specific episode |\n| POST | /episodes/{id}/relationships/media_ratings | Associate media_ratings with a episode |\n\n### Episode_versions\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /episode_versions | Get a list of episode versions |\n| POST | /episode_versions | Create a new episode version |\n| DELETE | /episode_versions/{id} | Delete an episode version |\n| GET | /episode_versions/{id} | Get a specific episode version |\n| PATCH | /episode_versions/{id} | Update an episode version |\n\n### Feeds\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /feeds | Get a list of feeds |\n| POST | /feeds | Create a new feed |\n| DELETE | /feeds/{id} | Delete a specific feed |\n| GET | /feeds/{id} | Get a specific feed |\n| PATCH | /feeds/{id} | Update a specific feed |\n| GET | /feeds/{id}.jpeg | Get image file |\n\n### Feed_items\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /feed_items | Get a list of feed items |\n| POST | /feed_items | Create a new feed item |\n| DELETE | /feed_items/{id} | Delete a specific feed item |\n| GET | /feed_items/{id} | Get a specific feed item |\n| PATCH | /feed_items/{id} | Update a specific feed item |\n| GET | /feed_items/{id}.jpeg | Get image file |\n| GET | /feed_items/{id}.mp3 | Get audio file |\n\n### Genres\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /genres | Get a list of genres |\n| GET | /genres/{id} | Get a specific genre |\n\n### Series\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /series/{id}/relationships/genres | Remove genre associations from a series |\n| GET | /series/{id}/relationships/genres | Get genres for a specific series |\n| POST | /series/{id}/relationships/genres | Associate genres with a series |\n| DELETE | /series/{id}/relationships/languages | Remove language associations from a series |\n| GET | /series/{id}/relationships/languages | Get languages for a specific series |\n| POST | /series/{id}/relationships/languages | Associate languages with a series |\n| DELETE | /series/{id}/relationships/media_ratings | Remove media_rating associations from a series |\n| GET | /series/{id}/relationships/media_ratings | Get media_ratings for a specific series |\n| POST | /series/{id}/relationships/media_ratings | Associate media_ratings with a series |\n| GET | /series | Get a list of series |\n| GET | /series/{id} | Get a specific series |\n| PATCH | /series/{id} | Update a specific series |\n| GET | /series/{id}.jpeg | Get image file |\n\n### Images\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /images | Get a list of images |\n| POST | /images | Create a new image |\n| DELETE | /images/{id} | Delete an image |\n| GET | /images/{id} | Get a specific image |\n\n### Languages\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /languages | Get a list of languages |\n| GET | /languages/{id} | Get a specific language |\n\n### Marker_points\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /marker_points | Get a list of marker points |\n| POST | /marker_points | Create a new marker point |\n| DELETE | /marker_points/{id} | Delete a marker point |\n| GET | /marker_points/{id} | Get a specific marker point |\n| PATCH | /marker_points/{id} | Update a marker point |\n\n### Marker_point_content_rules\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /marker_point_content_rules | Get a list of marker point content rules |\n| POST | /marker_point_content_rules | Create a new marker point content rule |\n| DELETE | /marker_point_content_rules/{id} | Delete a marker point content rule |\n| GET | /marker_point_content_rules/{id} | Get a specific marker point content rule |\n| PATCH | /marker_point_content_rules/{id} | Update a marker point content rule |\n\n### Media_assets\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /media_assets | Get a list of media assets |\n| GET | /media_assets/{id} | Get a specific media asset |\n\n### Media_ratings\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /media_ratings | Get a list of media ratings |\n| GET | /media_ratings/{id} | Get a specific media rating |\n\n### Seasons\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /seasons/{id}/relationships/media_ratings | Remove media_rating associations from a season |\n| GET | /seasons/{id}/relationships/media_ratings | Get media_ratings for a specific season |\n| POST | /seasons/{id}/relationships/media_ratings | Associate media_ratings with a season |\n| GET | /seasons | Get a list of seasons |\n| POST | /seasons | Create a new season |\n| DELETE | /seasons/{id} | Delete a specific season |\n| GET | /seasons/{id} | Get a specific season |\n| PATCH | /seasons/{id} | Update a specific season |\n| GET | /seasons/{id}.jpeg | Get image file |\n\n### Networks\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /networks | Get a list of networks |\n| GET | /networks/{id} | Get a specific network |\n| PATCH | /networks/{id} | Update a specific network |\n| GET | /networks/{id}.jpeg | Get image file |\n\n### People\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /people | Get a list of people |\n| POST | /people | Create a new person |\n| GET | /people/{id} | Get a specific person |\n| PATCH | /people/{id} | Update a specific person |\n| GET | /people/{id}.jpeg | Get image file |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Search classifications?\" -> GET /classifications\n- \"Get classification details?\" -> GET /classifications/{id}\n- \"Search classification_inclusions?\" -> GET /classification_inclusions\n- \"Get classification_inclusion details?\" -> GET /classification_inclusions/{id}\n- \"List all credits?\" -> GET /credits\n- \"Create a credit?\" -> POST /credits\n- \"Delete a credit?\" -> DELETE /credits/{id}\n- \"Get credit details?\" -> GET /credits/{id}\n- \"Partially update a credit?\" -> PATCH /credits/{id}\n- \"Search episodes?\" -> GET /episodes\n- \"Create a episode?\" -> POST /episodes\n- \"Delete a episode?\" -> DELETE /episodes/{id}\n- \"Get episode details?\" -> GET /episodes/{id}\n- \"Partially update a episode?\" -> PATCH /episodes/{id}\n- \"List all next_sibling?\" -> GET /episodes/{id}/next_sibling\n- \"List all previous_sibling?\" -> GET /episodes/{id}/previous_sibling\n- \"List all episode_versions?\" -> GET /episode_versions\n- \"Create a episode_version?\" -> POST /episode_versions\n- \"Delete a episode_version?\" -> DELETE /episode_versions/{id}\n- \"Get episode_version details?\" -> GET /episode_versions/{id}\n- \"Partially update a episode_version?\" -> PATCH /episode_versions/{id}\n- \"List all feeds?\" -> GET /feeds\n- \"Create a feed?\" -> POST /feeds\n- \"Delete a feed?\" -> DELETE /feeds/{id}\n- \"Get feed details?\" -> GET /feeds/{id}\n- \"Partially update a feed?\" -> PATCH /feeds/{id}\n- \"Search feed_items?\" -> GET /feed_items\n- \"Create a feed_item?\" -> POST /feed_items\n- \"Delete a feed_item?\" -> DELETE /feed_items/{id}\n- \"Get feed_item details?\" -> GET /feed_items/{id}\n- \"Partially update a feed_item?\" -> PATCH /feed_items/{id}\n- \"Search genres?\" -> GET /genres\n- \"Get genre details?\" -> GET /genres/{id}\n- \"List all genres?\" -> GET /series/{id}/relationships/genres\n- \"Create a genre?\" -> POST /series/{id}/relationships/genres\n- \"List all images?\" -> GET /images\n- \"Create a image?\" -> POST /images\n- \"Delete a image?\" -> DELETE /images/{id}\n- \"Get image details?\" -> GET /images/{id}\n- \"Search languages?\" -> GET /languages\n- \"Get language details?\" -> GET /languages/{id}\n- \"List all languages?\" -> GET /series/{id}/relationships/languages\n- \"Create a language?\" -> POST /series/{id}/relationships/languages\n- \"List all marker_points?\" -> GET /marker_points\n- \"Create a marker_point?\" -> POST /marker_points\n- \"Delete a marker_point?\" -> DELETE /marker_points/{id}\n- \"Get marker_point details?\" -> GET /marker_points/{id}\n- \"Partially update a marker_point?\" -> PATCH /marker_points/{id}\n- \"List all marker_point_content_rules?\" -> GET /marker_point_content_rules\n- \"Create a marker_point_content_rule?\" -> POST /marker_point_content_rules\n- \"Delete a marker_point_content_rule?\" -> DELETE /marker_point_content_rules/{id}\n- \"Get marker_point_content_rule details?\" -> GET /marker_point_content_rules/{id}\n- \"Partially update a marker_point_content_rule?\" -> PATCH /marker_point_content_rules/{id}\n- \"List all media_assets?\" -> GET /media_assets\n- \"Get media_asset details?\" -> GET /media_assets/{id}\n- \"Search media_ratings?\" -> GET /media_ratings\n- \"Get media_rating details?\" -> GET /media_ratings/{id}\n- \"List all media_ratings?\" -> GET /episodes/{id}/relationships/media_ratings\n- \"Create a media_rating?\" -> POST /episodes/{id}/relationships/media_ratings\n- \"Search networks?\" -> GET /networks\n- \"Get network details?\" -> GET /networks/{id}\n- \"Partially update a network?\" -> PATCH /networks/{id}\n- \"Search people?\" -> GET /people\n- \"Create a people?\" -> POST /people\n- \"Get people details?\" -> GET /people/{id}\n- \"Partially update a people?\" -> PATCH /people/{id}\n- \"Search seasons?\" -> GET /seasons\n- \"Create a season?\" -> POST /seasons\n- \"Delete a season?\" -> DELETE /seasons/{id}\n- \"Get season details?\" -> GET /seasons/{id}\n- \"Partially update a season?\" -> PATCH /seasons/{id}\n- \"Search series?\" -> GET /series\n- \"Get sery details?\" -> GET /series/{id}\n- \"Partially update a sery?\" -> PATCH /series/{id}\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api ART19 Content API Documentation\n@base https://art19.com/\n@version 1.0.0\n@auth ApiKey Authorization in header\n@endpoints 92\n@hint download_for_search\n@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)\n\n@group classifications\n@endpoint GET /classifications\n@desc Get a list of classifications\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100., type: any # Limit the result to classifications of this type. The possible values for types depends on the privileges of the provided credential., q: any # Limit the result to classifications with a value containing the parameter value disregarding case., is_country: any # If this parameter is provided and not empty, limit the result to classifications of type `Geography` representing countries. The credential must have at least one privilege with a network, series, or advertiser profile., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100. Filtering by type for AudienceSegment, AudienceTag, ListeningPlatform, and UserDevice is no longer supported., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint GET /classifications/{id}\n@desc Get a specific classification\n@required {id: any # The ID of the classification resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endgroup\n\n@group classification_inclusions\n@endpoint GET /classification_inclusions\n@desc Get ClassificationInclusion records\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100., classification_id: any # Limit the result to classification inclusions linked to a classification with this ID., classification_type: any # The type of classification that the classification inclusions are linked to. Depending on the permissions of your credential, only a subset of these types are usable., classified_id: any # Limit the result to classification inclusions linked to a resource with this ID. You will have to use this filter together with either `classified_type` or `classification_type`., classified_type: any # Limit the result to classification inclusions linked to this type of entity., q: any # Limit the result to classification inclusions linked to a classification containing the parameter value disregarding case., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100. At least one filter parameter is required., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint GET /classification_inclusions/{id}\n@desc Get a specific classification inclusion\n@required {id: any # The ID of the classification inclusion resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endgroup\n\n@group credits\n@endpoint GET /credits\n@desc Get a list of credits\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100., creditable_id: any # Limit the result to credits for the entity with this ID only. If the entity is not published, the credential needs to have the right privilege to list the credits for it., creditable_type: any # Limit the result to credits linked to this type of entity only. Depending on the privileges of the credential, this list might be further reduced to only published entities., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /credits\n@desc Create a new credit\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint DELETE /credits/{id}\n@desc Delete a specific credit\n@returns(204) No Content  The resource has been deleted successfully.\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /credits/{id}\n@desc Get a specific credit\n@required {id: any # The ID of the credit resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /credits/{id}\n@desc Update a specific credit\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endgroup\n\n@group episodes\n@endpoint GET /episodes\n@desc Get a list of episodes\n@required {page[number]: any: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., has_downloads: any # If `true`, limit the result to episodes that have been downloaded., included_in_inventory_calendar: any # Limit the result to episodes usable with an inventory management calendar for the provided AdDeal ID., itunes_type: any # Limit the result to episodes with matching types., month: any # Limit the result to episodes released in this month., published: any # If `true`, limit the result to published episodes only. If `false`, limit the result to _unpublished_ episodes only., q: any # Limit the result to episodes with a title containing this parameter in a case-insensitive way., released_after: any # Limit the result to episodes released after this timestamp., released_before: any # Limit the result to episodes released before this timestamp., rss: any # If `true`, limit the result to published and released episodes holding an available media file. If this is `true`, it also changes the default sort order to `-released_at`., season_id: any # Limit result to episodes linked to this season., series_id: any # Limit the result to episodes linked to this series., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general., year: any # Limit the result to episodes released in this year.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must be present and have a positive page number and a page size no larger than 100. One initial filter must be provided (`ids`, `series_id`, or `season_id`)., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /episodes\n@desc Create a new episode\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint DELETE /episodes/{id}\n@desc Delete a specific episode\n@returns(204) No Content  The resource has been deleted successfully.\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /episodes/{id}\n@desc Get a specific episode\n@required {id: any # The ID of the episode resource to load.}\n@optional {include: any # Include related resources in the response. The related resources will be returned in the top-level `included` array. Multiple relationships can be included by separating them with commas. Nested relationships can be specified using dot notation (e.g., `series.network`). Available relationships: `active_version`, `cover_image`, `season`, `series`, `series.cover_image`, `series.network`.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Invalid include parameter values are not permitted., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /episodes/{id}\n@desc Update a specific episode\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /episodes/{id}.jpeg\n@desc Get image file\n@required {id: any # The UUID of the episode}\n@optional {style: any # The image style/size to retrieve}\n@errors {302: Redirect to image file URL (CDN or S3), 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6).}\n\n@endpoint GET /episodes/{id}.mp3\n@desc Get audio file\n@required {id: any # The UUID of the episode}\n@optional {type: any # The audio type to retrieve}\n@errors {302: Redirect to audio file URL (CDN or S3), 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6).}\n\n@endpoint GET /episodes/{id}/next_sibling\n@desc Get the episode released right after the specified one\n@required {id: any # The ID of the episode to find the one episode released right after it.}\n@optional {rss: any # If `true`, get the next released and published episode with an available media file.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint GET /episodes/{id}/previous_sibling\n@desc Get the episode released right before the specified one\n@required {id: any # The ID of the episode to find the one episode released right before it.}\n@optional {rss: any # If `true`, get the previously released and published episode with an available media file.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endgroup\n\n@group episode_versions\n@endpoint GET /episode_versions\n@desc Get a list of episode versions\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., episode_id: any # Filter by episode ID, feed_item_id: any # Filter by feed item ID, page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /episode_versions\n@desc Create a new episode version\n@required {body: map}\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint DELETE /episode_versions/{id}\n@desc Delete an episode version\n@required {id: any # The ID of the episode version to delete}\n@returns(204) No Content  The resource has been deleted successfully.\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /episode_versions/{id}\n@desc Get a specific episode version\n@required {id: any # The ID of the episode version resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /episode_versions/{id}\n@desc Update an episode version\n@required {body: map}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded  This can occur for two reasons: 1. General API rate limit: You have exceeded the number of API calls per minute granted to your credential 2. Transcoding concurrency limit: You have exceeded the maximum number of concurrent episode versions being processed for transcoding  For transcoding limits, wait for current episode versions to finish processing before submitting new ones., 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endgroup\n\n@group feeds\n@endpoint GET /feeds\n@desc Get a list of feeds\n@required {page[number]: any: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., primary: any # If `true`, limit the result to primary feeds only. `false` will limit results to alternate feeds., series_id: any # Limit the result to feeds linked to this series.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must be present and have a positive page number and a page size no larger than 100. One initial filter must be provided (`ids` or `series_id`)., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /feeds\n@desc Create a new feed\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint DELETE /feeds/{id}\n@desc Delete a specific feed\n@returns(204) No Content  The resource has been deleted successfully.\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /feeds/{id}\n@desc Get a specific feed\n@required {id: any # The ID of the feed resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /feeds/{id}\n@desc Update a specific feed\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /feeds/{id}.jpeg\n@desc Get image file\n@required {id: any # The UUID of the feed}\n@optional {style: any # The image style/size to retrieve}\n@errors {302: Redirect to image file URL (CDN or S3), 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6).}\n\n@endgroup\n\n@group feed_items\n@endpoint GET /feed_items\n@desc Get a list of feed items\n@required {page[number]: any: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., episode_id: any # Limit the result to feed items linked to this episode., feed_id: any # Limit the result to feed items linked to these feeds., itunes_type: any # Limit the result to feed items with matching iTunes types., published: any # If `true`, limit the result to published feed items only. If `false`, limit the result to _unpublished_ feed items only., q: any # Limit the result to feed items with a title containing this parameter in a case-insensitive way., released_after: any # Limit the result to feed items released after this timestamp., released_before: any # Limit the result to feed items released before this timestamp., series_id: any # Limit the result to feed items linked to this series., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must be present and have a positive page number and a page size no larger than 100. One initial filter must be provided (`ids`, `episode_id`, `feed_id`, or `series_id`)., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /feed_items\n@desc Create a new feed item\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint DELETE /feed_items/{id}\n@desc Delete a specific feed item\n@returns(204) No Content  The resource has been deleted successfully.\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /feed_items/{id}\n@desc Get a specific feed item\n@required {id: any # The ID of the feed item resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /feed_items/{id}\n@desc Update a specific feed item\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /feed_items/{id}.jpeg\n@desc Get image file\n@required {id: any # The UUID of the feed item}\n@optional {style: any # The image style/size to retrieve}\n@errors {302: Redirect to image file URL (CDN or S3), 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6).}\n\n@endpoint GET /feed_items/{id}.mp3\n@desc Get audio file\n@required {id: any # The UUID of the feed item}\n@optional {type: any # The audio type to retrieve}\n@errors {302: Redirect to audio file URL (CDN or S3), 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6).}\n\n@endgroup\n\n@group genres\n@endpoint GET /genres\n@desc Get a list of genres\n@required {page[number]: any: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., q: any # Limit the result to genres with a value containing this parameter in a case-insensitive way., series_id: any # Limit the result to genres associated with this series., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must be present and have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint GET /genres/{id}\n@desc Get a specific genre\n@required {id: any # The ID of the genre resource to load.}\n@optional {include: any # Include related resources in the response. The related resources will be returned in the top-level `included` array. Multiple relationships can be included by separating them with commas. Nested relationships can be specified using dot notation (e.g., `series.network`). Available relationships: `parent`.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Invalid include parameter values are not permitted., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endgroup\n\n@group series\n@endpoint DELETE /series/{id}/relationships/genres\n@desc Remove genre associations from a series\n@required {id: any # The ID of the series., body: any # Request body containing resource identifier objects for genres to remove.}\n@returns(204) No Content - Relationship successfully removed\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endpoint GET /series/{id}/relationships/genres\n@desc Get genres for a specific series\n@required {id: any # The ID of the series., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@returns(200) Success\n@errors {400: Bad Request - Pagination must be present and have a positive page number and a page size no larger than 100}\n\n@endpoint POST /series/{id}/relationships/genres\n@desc Associate genres with a series\n@required {id: any # The ID of the series., body: any # Request body containing resource identifier objects for genres to associate.}\n@returns(204) No Content - Relationship successfully created\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endgroup\n\n@group images\n@endpoint GET /images\n@desc Get a list of images\n@required {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4).}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /images\n@desc Create a new image\n@required {body: map}\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint DELETE /images/{id}\n@desc Delete an image\n@required {id: any # The ID of the image to delete}\n@returns(204) No Content  The resource has been deleted successfully.\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /images/{id}\n@desc Get a specific image\n@required {id: any # The ID of the image resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endgroup\n\n@group languages\n@endpoint GET /languages\n@desc Get a list of languages\n@required {page[number]: any: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., q: any # Limit the result to languages with a value containing this parameter in a case-insensitive way., series_id: any # Limit the result to languages associated with this series., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must be present and have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint GET /languages/{id}\n@desc Get a specific language\n@required {id: any # The ID of the language resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endgroup\n\n@group series\n@endpoint DELETE /series/{id}/relationships/languages\n@desc Remove language associations from a series\n@required {id: any # The ID of the series., body: any # Request body containing resource identifier objects for languages to remove.}\n@returns(204) No Content - Relationship successfully removed\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endpoint GET /series/{id}/relationships/languages\n@desc Get languages for a specific series\n@required {id: any # The ID of the series., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@returns(200) Success\n@errors {400: Bad Request - Pagination must be present and have a positive page number and a page size no larger than 100}\n\n@endpoint POST /series/{id}/relationships/languages\n@desc Associate languages with a series\n@required {id: any # The ID of the series., body: any # Request body containing resource identifier objects for languages to associate.}\n@returns(204) No Content - Relationship successfully created\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endgroup\n\n@group marker_points\n@endpoint GET /marker_points\n@desc Get a list of marker points\n@required {page[number]: any: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., episode_id: any # Limit the result to marker points linked to the live version of this episode., episode_version_id: any # Limit the result to marker points linked to this episode version., season_id: any # Limit the result to default marker points linked to this season., series_id: any # Limit the result to default marker points linked to this series., type: any # Filter by marker point type.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /marker_points\n@desc Create a new marker point\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint DELETE /marker_points/{id}\n@desc Delete a marker point\n@required {id: any # The ID of the marker point to delete}\n@returns(204) No Content  The resource has been deleted successfully.\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /marker_points/{id}\n@desc Get a specific marker point\n@required {id: any # The ID of the marker point resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /marker_points/{id}\n@desc Update a marker point\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endgroup\n\n@group marker_point_content_rules\n@endpoint GET /marker_point_content_rules\n@desc Get a list of marker point content rules\n@required {page[number]: any: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., marker_point_id: any # Limit the results to marker point content rules linked to this marker point., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /marker_point_content_rules\n@desc Create a new marker point content rule\n@required {body: map}\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint DELETE /marker_point_content_rules/{id}\n@desc Delete a marker point content rule\n@required {id: any # The ID of the marker point content rule to delete}\n@returns(204) No Content  The resource has been deleted successfully.\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /marker_point_content_rules/{id}\n@desc Get a specific marker point content rule\n@required {id: any # The ID of the marker point content rule resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /marker_point_content_rules/{id}\n@desc Update a marker point content rule\n@required {body: map}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endgroup\n\n@group media_assets\n@endpoint GET /media_assets\n@desc Get a list of media assets\n@required {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4).}\n@optional {attachment_id: any # Must also use the `attachment_type` param: limit the result to media assets owned by this attachment., attachment_type: any # Must also use the `attachment_id` param: limit the result to media assets owned by this attachment., style: any # Limit the result to media assets with this style.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint GET /media_assets/{id}\n@desc Get a specific media asset\n@required {id: any # The ID of the media asset resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endgroup\n\n@group media_ratings\n@endpoint GET /media_ratings\n@desc Get a list of media ratings\n@required {page[number]: any: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., q: any # Limit the result to media ratings with a value containing this parameter in a case-insensitive way.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must be present and have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint GET /media_ratings/{id}\n@desc Get a specific media rating\n@required {id: any # The ID of the media rating resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endgroup\n\n@group episodes\n@endpoint DELETE /episodes/{id}/relationships/media_ratings\n@desc Remove media_rating associations from a episode\n@required {id: any # The ID of the episode., body: any # Request body containing resource identifier objects for media_ratings to remove.}\n@returns(204) No Content - Relationship successfully removed\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endpoint GET /episodes/{id}/relationships/media_ratings\n@desc Get media_ratings for a specific episode\n@required {id: any # The ID of the episode., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@returns(200) Success\n@errors {400: Bad Request - Pagination must be present and have a positive page number and a page size no larger than 100}\n\n@endpoint POST /episodes/{id}/relationships/media_ratings\n@desc Associate media_ratings with a episode\n@required {id: any # The ID of the episode., body: any # Request body containing resource identifier objects for media_ratings to associate.}\n@returns(204) No Content - Relationship successfully created\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endgroup\n\n@group seasons\n@endpoint DELETE /seasons/{id}/relationships/media_ratings\n@desc Remove media_rating associations from a season\n@required {id: any # The ID of the season., body: any # Request body containing resource identifier objects for media_ratings to remove.}\n@returns(204) No Content - Relationship successfully removed\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endpoint GET /seasons/{id}/relationships/media_ratings\n@desc Get media_ratings for a specific season\n@required {id: any # The ID of the season., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@returns(200) Success\n@errors {400: Bad Request - Pagination must be present and have a positive page number and a page size no larger than 100}\n\n@endpoint POST /seasons/{id}/relationships/media_ratings\n@desc Associate media_ratings with a season\n@required {id: any # The ID of the season., body: any # Request body containing resource identifier objects for media_ratings to associate.}\n@returns(204) No Content - Relationship successfully created\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endgroup\n\n@group series\n@endpoint DELETE /series/{id}/relationships/media_ratings\n@desc Remove media_rating associations from a series\n@required {id: any # The ID of the series., body: any # Request body containing resource identifier objects for media_ratings to remove.}\n@returns(204) No Content - Relationship successfully removed\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endpoint GET /series/{id}/relationships/media_ratings\n@desc Get media_ratings for a specific series\n@required {id: any # The ID of the series., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@returns(200) Success\n@errors {400: Bad Request - Pagination must be present and have a positive page number and a page size no larger than 100}\n\n@endpoint POST /series/{id}/relationships/media_ratings\n@desc Associate media_ratings with a series\n@required {id: any # The ID of the series., body: any # Request body containing resource identifier objects for media_ratings to associate.}\n@returns(204) No Content - Relationship successfully created\n@errors {400: Bad Request - Invalid request body format or missing required data, 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem.}\n\n@endgroup\n\n@group networks\n@endpoint GET /networks\n@desc Get a list of networks\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100., q: any # Limit the result to networks with a name containing this parameter in a case-insensitive way., ad_rep_account_id: any # Limit the result to networks containing at least one series with an ad deal of this Ad Ops profile., ad_deal_status: any # Limit the result to networks containing at least one series with an ad deal matching one of the values in this parameter., parent_id: any # Limit the result to networks who are child networks of this parent., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint GET /networks/{id}\n@desc Get a specific network\n@required {id: any # The ID of the network resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /networks/{id}\n@desc Update a specific network\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /networks/{id}.jpeg\n@desc Get image file\n@required {id: any # The UUID of the network}\n@optional {style: any # The image style/size to retrieve}\n@errors {302: Redirect to image file URL (CDN or S3), 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6).}\n\n@endgroup\n\n@group people\n@endpoint GET /people\n@desc Get a list of people\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100., q: any # Limit the result to people with a full name containing this parameter in a case-insensitive way., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /people\n@desc Create a new person\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /people/{id}\n@desc Get a specific person\n@required {id: any # The ID of the person resource to load.}\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /people/{id}\n@desc Update a specific person\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /people/{id}.jpeg\n@desc Get image file\n@required {id: any # The UUID of the person}\n@optional {style: any # The image style/size to retrieve}\n@errors {302: Redirect to image file URL (CDN or S3), 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6).}\n\n@endgroup\n\n@group seasons\n@endpoint GET /seasons\n@desc Get a list of seasons\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., page[number]: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100., series_id: any # Limit the result to seasons owned by this series., q: any # Limit the result to seasons with a title containing this parameter in a case-insensitive way., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint POST /seasons\n@desc Create a new season\n@returns(201) Created\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint DELETE /seasons/{id}\n@desc Delete a specific season\n@returns(204) No Content  The resource has been deleted successfully.\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /seasons/{id}\n@desc Get a specific season\n@required {id: any # The ID of the season resource to load.}\n@optional {include: any # Include related resources in the response. The related resources will be returned in the top-level `included` array. Multiple relationships can be included by separating them with commas. Nested relationships can be specified using dot notation (e.g., `series.network`). Available relationships: `cover_image`, `series`, `series.cover_image`, `series.network`.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Invalid include parameter values are not permitted., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /seasons/{id}\n@desc Update a specific season\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /seasons/{id}.jpeg\n@desc Get image file\n@required {id: any # The UUID of the season}\n@optional {style: any # The image style/size to retrieve}\n@errors {302: Redirect to image file URL (CDN or S3), 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6).}\n\n@endgroup\n\n@group series\n@endpoint GET /series\n@desc Get a list of series\n@required {page[number]: any: any # Select which page number to receive results for. Pages are numbered starting at 1., page[size]: any # Indicate how many records to return per page. The maximum is 100.}\n@optional {ids[]: any: any # The list of IDs to filter by. Repeat this parameter for each ID you want to include in the filter. The brackets *MUST* be percent-encoded, per the requirements in [RFC 3986 § 3.4](https://tools.ietf.org/html/rfc3986#section-3.4)., ad_rep_account_id: any # Limit the result to series with an ad deal of this Ad Ops profile., network_id: any # Limit the result to series owned by this network., parent_network_id: any # Limit the result to all series owned by this network and any child networks., q: any # Limit the result to series with a title or slug containing this parameter in a case-insensitive way., sort: any # Specify how to sort the result. Please refer to either the top section or the [JSON:API specification](https://jsonapi.org/format/#fetching-sorting) on how sorting works in general.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Pagination must have a positive page number and a page size no larger than 100., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint GET /series/{id}\n@desc Get a specific series\n@required {id: any # The ID of the series resource to load.}\n@optional {include: any # Include related resources in the response. The related resources will be returned in the top-level `included` array. Multiple relationships can be included by separating them with commas. Nested relationships can be specified using dot notation (e.g., `series.network`). Available relationships: `cover_image`, `network`.}\n@returns(200) Success\n@errors {400: Bad Request  Parameters requiring a specific format must adhere to that format. Invalid include parameter values are not permitted., 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 429: Rate Limit Exceeded}\n\n@endpoint PATCH /series/{id}\n@desc Update a specific series\n@returns(200) Success\n@errors {401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6)., 415: Unsupported Media Type  The attempt to create or change a resource failed because the media type provided is not JSON:API. Refer to the returned error document for further details to the cause of the problem., 422: Unprocessable Entity  The attempt to create or change a resource failed and the returned error document will provide further details to the cause of the problem., 429: Rate Limit Exceeded, 507: Insufficient Storage  The application is currently operating in READ ONLY mode and hence the server cannot store the representation needed to successfully complete the request. This is most likely due to maintenance. Please check [ART19's status page](https://status.art19.com) for further details.}\n\n@endpoint GET /series/{id}.jpeg\n@desc Get image file\n@required {id: any # The UUID of the series}\n@optional {style: any # The image style/size to retrieve}\n@errors {302: Redirect to image file URL (CDN or S3), 401: Unauthorized  A valid credential was not supplied, but one is required. [See RFC 7235 § 3.1](https://tools.ietf.org/html/rfc7235#section-3.1). A `WWW-Authenticate` header is not currently returned., 403: Forbidden  The provided credential is not authorized to access the requested resource or collection. [See RFC 7231 § 6.5.3](https://tools.ietf.org/html/rfc7231#section-6.5.3), 404: Not Found  The requested resource/collection does not exist. [See RFC 7231 § 6.5.4](https://tools.ietf.org/html/rfc7231#section-6.5.4)., 406: Not Acceptable  The client requested a response format which cannot be satisfied. Ensure that you specify the correct `Accept` header. [See RFC 7231 § 6.5.6](https://tools.ietf.org/html/rfc7231#section-6.5.6).}\n\n@endgroup\n\n@end\n"}}