openapi-directory

Version:

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

github.com/httptoolkit/openapi-directory-js

1 lines • 75.1 kB

JSON

{"openapi":"3.0.3","servers":[{"description":"Production server","url":"https://dev.to/api"}],"info":{"description":"Access Forem articles, users and other resources via API.\n For a real-world example of Forem in action, check out [DEV](https://www.dev.to).\n All endpoints can be accessed with the 'api-key' header and a accept header, but\n some of them are accessible publicly without authentication.\n\n Dates and date times, unless otherwise specified, must be in\n the [RFC 3339](https://tools.ietf.org/html/rfc3339) format.","title":"Forem API V1","version":"1.0.0","x-apisguru-categories":["social"],"x-origin":[{"format":"openapi","url":"https://raw.githubusercontent.com/forem/forem/main/swagger/v1/api_v1.json","version":"3.0"}],"x-providerName":"dev.to"},"security":[{"api-key":[]}],"paths":{"/api/admin/users":{"post":{"description":"This endpoint allows the client to trigger an invitation to the provided email address.\n\n It requires a token from a user with `super_admin` privileges.","operationId":"postAdminUsersCreate","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserInviteParam"}}}},"responses":{"200":{"description":"Successful"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"example":{"error":"param is missing or the value is empty: email","status":422}}},"description":"Unprocessable Entity"}},"summary":"Invite a User","tags":["users"]}},"/api/articles":{"get":{"description":"This endpoint allows the client to retrieve a list of articles.\n\n\"Articles\" are all the posts that users create on DEV that typically\nshow up in the feed. They can be a blog post, a discussion question,\na help thread etc. but is referred to as article within the code.\n\nBy default it will return featured, published articles ordered\nby descending popularity.\n\nIt supports pagination, each page will contain `30` articles by default.","operationId":"getArticles","parameters":[{"$ref":"#/components/parameters/pageParam"},{"$ref":"#/components/parameters/perPageParam30to1000"},{"description":"Using this parameter will retrieve articles that contain the requested tag. Articles\nwill be ordered by descending popularity.This parameter can be used in conjuction with `top`.","example":"discuss","in":"query","name":"tag","required":false,"schema":{"type":"string"}},{"description":"Using this parameter will retrieve articles with any of the comma-separated tags.\nArticles will be ordered by descending popularity.","example":"javascript, css","in":"query","name":"tags","required":false,"schema":{"type":"string"}},{"description":"Using this parameter will retrieve articles that do _not_ contain _any_\nof comma-separated tags. Articles will be ordered by descending popularity.","example":"node, java","in":"query","name":"tags_exclude","required":false,"schema":{"type":"string"}},{"description":"Using this parameter will retrieve articles belonging\n to a User or Organization ordered by descending publication date.\n If `state=all` the number of items returned will be `1000` instead of the default `30`.\n This parameter can be used in conjuction with `state`.","example":"ben","in":"query","name":"username","required":false,"schema":{"type":"string"}},{"description":"Using this parameter will allow the client to check which articles are fresh or rising.\n If `state=fresh` the server will return fresh articles.\n If `state=rising` the server will return rising articles.\n This param can be used in conjuction with `username`, only if set to `all`.","example":"fresh","in":"query","name":"state","required":false,"schema":{"enum":["fresh","rising","all"],"type":"string"}},{"description":"Using this parameter will allow the client to return the most popular articles\nin the last `N` days.\n`top` indicates the number of days since publication of the articles returned.\nThis param can be used in conjuction with `tag`.","example":2,"in":"query","name":"top","required":false,"schema":{"format":"int32","minimum":1,"type":"integer"}},{"description":"Adding this will allow the client to return the list of articles\nbelonging to the requested collection, ordered by ascending publication date.","example":99,"in":"query","name":"collection_id","required":false,"schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":[{"canonical_url":"http://localhost:3000/username387/ah-wilderness175-1gok","collection_id":null,"comments_count":0,"cover_image":"http://localhost:3000/assets/34-d27f3a4a9f6f1f373003c74b31749764691f510b2a18b55039478583864a067e.png","created_at":"2025-04-15T13:50:46.503Z","crossposted_at":null,"description":"Thundercats iphone mumblecore pop-up cray dreamcatcher typewriter. 3 wolf moon hoodie bitters...","edited_at":null,"flare_tag":{"bg_color_hex":"#000000","name":"discuss","text_color_hex":"#ffffff"},"id":791,"last_comment_at":"2025-04-15T13:50:46.503Z","organization":{"name":"Rogahn Group","profile_image":"/uploads/organization/profile_image/326/438cc370-6426-4da7-bec2-8ec0759cd1d7.png","profile_image_90":"/uploads/organization/profile_image/326/438cc370-6426-4da7-bec2-8ec0759cd1d7.png","slug":"org70","username":"org70"},"path":"/username387/ah-wilderness175-1gok","positive_reactions_count":0,"public_reactions_count":0,"published_at":"2025-04-15T13:50:46.503Z","published_timestamp":"2025-04-15T13:50:46.503Z","readable_publish_date":"Apr 7","reading_time_minutes":1,"slug":"ah-wilderness175-1gok","social_image":"http://localhost:3000/assets/34-d27f3a4a9f6f1f373003c74b31749764691f510b2a18b55039478583864a067e.png","tag_list":["discuss"],"tags":"discuss","title":"Ah, Wilderness!175","type_of":"article","url":"http://localhost:3000/username387/ah-wilderness175-1gok","user":{"github_username":"github387","name":"Arden \"Vera\" \\:/ Gorczany","profile_image":"/uploads/user/profile_image/1826/f6365991-cba0-43a1-914e-1c7eddb7618b.jpeg","profile_image_90":"/uploads/user/profile_image/1826/f6365991-cba0-43a1-914e-1c7eddb7618b.jpeg","twitter_username":"twitter387","user_id":1826,"username":"username387","website_url":null}}],"schema":{"items":{"$ref":"#/components/schemas/ArticleIndex"},"type":"array"}}},"description":"A List of Articles"}},"security":[],"summary":"Published articles","tags":["articles"]},"post":{"description":"This endpoint allows the client to create a new article.\n\n\"Articles\" are all the posts that users create on DEV that typically show up in the feed. They can be a blog post, a discussion question, a help thread etc. but is referred to as article within the code.","operationId":"createArticle","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article"}}}},"responses":{"201":{"content":{"application/json":{"example":{"body_html":"New body for the article\n\n","body_markdown":"**New** body for the article","canonical_url":"https://dev.to/fdocr/headless-chrome-dual-mode-tests-for-ruby-on-rails-4p6g","collection_id":33,"comments_count":0,"cover_image":"https://thepracticaldev.s3.amazonaws.com/i/5wfo25724gzgk5e5j50g.jpg","created_at":"2025-04-15T13:50:46.503Z","crossposted_at":null,"description":"New post example","edited_at":null,"id":788,"last_comment_at":"2025-04-15T13:50:46.503Z","path":"/username383/new-article-4l9a","positive_reactions_count":0,"public_reactions_count":0,"published_at":"2025-04-15T13:50:46.503Z","published_timestamp":"2025-04-15T13:50:46.503Z","readable_publish_date":"Apr 7","reading_time_minutes":1,"slug":"new-article-4l9a","social_image":"https://thepracticaldev.s3.amazonaws.com/i/5wfo25724gzgk5e5j50g.jpg","tag_list":"","tags":[],"title":"New article","type_of":"article","url":"http://localhost:3000/username383/new-article-4l9a","user":{"github_username":"github383","name":"Felicita \"Doug\" \\:/ Conroy","profile_image":"/uploads/user/profile_image/1822/9d77b0c7-c1cd-4661-86aa-fabe8b5634bd.jpeg","profile_image_90":"/uploads/user/profile_image/1822/9d77b0c7-c1cd-4661-86aa-fabe8b5634bd.jpeg","twitter_username":"twitter383","user_id":1822,"username":"username383","website_url":null}}}},"description":"An Article"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"example":{"error":"param is missing or the value is empty: article","status":422}}},"description":"Unprocessable Entity"}},"summary":"Publish article","tags":["articles"]}},"/api/articles/latest":{"get":{"description":"This endpoint allows the client to retrieve a list of articles. ordered by descending publish date.\n\nIt supports pagination, each page will contain 30 articles by default.","operationId":"getLatestArticles","parameters":[{"$ref":"#/components/parameters/pageParam"},{"$ref":"#/components/parameters/perPageParam30to1000"}],"responses":{"200":{"content":{"application/json":{"example":[{"canonical_url":"http://localhost:3000/username390/a-summer-bird-cage178-48nc","collection_id":null,"comments_count":0,"cover_image":"http://localhost:3000/assets/23-33ea5a2b5af3dc15b9ed90de0b850f67e2390eaec3361d6687d3b9750c699f84.png","created_at":"2025-04-15T13:50:46.503Z","crossposted_at":null,"description":"Portland waistcoat fingerstache vinyl butcher. Tumblr kale chips mixtape. Direct trade stumptown vhs...","edited_at":null,"flare_tag":{"bg_color_hex":"#000000","name":"discuss","text_color_hex":"#ffffff"},"id":794,"last_comment_at":"2025-04-15T13:50:46.503Z","path":"/username390/a-summer-bird-cage178-48nc","positive_reactions_count":0,"public_reactions_count":0,"published_at":"2025-04-15T13:50:46.503Z","published_timestamp":"2025-04-15T13:50:46.503Z","readable_publish_date":"Apr 7","reading_time_minutes":1,"slug":"a-summer-bird-cage178-48nc","social_image":"http://localhost:3000/assets/23-33ea5a2b5af3dc15b9ed90de0b850f67e2390eaec3361d6687d3b9750c699f84.png","tag_list":["javascript","html","discuss"],"tags":"javascript, html, discuss","title":"A Summer Bird-Cage178","type_of":"article","url":"http://localhost:3000/username390/a-summer-bird-cage178-48nc","user":{"github_username":"github390","name":"Florencio \"Lorie\" \\:/ Heidenreich","profile_image":"/uploads/user/profile_image/1829/425917eb-2b42-4fa5-ad6c-1c28e0758af6.jpeg","profile_image_90":"/uploads/user/profile_image/1829/425917eb-2b42-4fa5-ad6c-1c28e0758af6.jpeg","twitter_username":"twitter390","user_id":1829,"username":"username390","website_url":null}},{"canonical_url":"http://localhost:3000/username389/the-road-less-traveled177-3pbl","collection_id":null,"comments_count":0,"cover_image":"http://localhost:3000/assets/4-dcfcc4d8dd259bc0751c2de24b1cf244b181c789934368ca1cb471f0944b695d.png","created_at":"2025-04-15T13:50:46.503Z","crossposted_at":null,"description":"Kale chips lo-fi godard. Knausgaard meggings chillwave gluten-free keytar etsy. Diy phlogiston godard...","edited_at":null,"flare_tag":{"bg_color_hex":"#000000","name":"discuss","text_color_hex":"#ffffff"},"id":793,"last_comment_at":"2025-04-15T13:50:46.503Z","path":"/username389/the-road-less-traveled177-3pbl","positive_reactions_count":0,"public_reactions_count":0,"published_at":"2025-04-15T13:50:46.503Z","published_timestamp":"2025-04-15T13:50:46.503Z","readable_publish_date":"Apr 7","reading_time_minutes":1,"slug":"the-road-less-traveled177-3pbl","social_image":"http://localhost:3000/assets/4-dcfcc4d8dd259bc0751c2de24b1cf244b181c789934368ca1cb471f0944b695d.png","tag_list":["javascript","html","discuss"],"tags":"javascript, html, discuss","title":"The Road Less Traveled177","type_of":"article","url":"http://localhost:3000/username389/the-road-less-traveled177-3pbl","user":{"github_username":"github389","name":"Mark \"Gina\" \\:/ Grimes","profile_image":"/uploads/user/profile_image/1828/c3970f90-a350-41e1-b563-9d7feea34839.jpeg","profile_image_90":"/uploads/user/profile_image/1828/c3970f90-a350-41e1-b563-9d7feea34839.jpeg","twitter_username":"twitter389","user_id":1828,"username":"username389","website_url":null}},{"canonical_url":"http://localhost:3000/username388/where-angels-fear-to-tread176-4e3g","collection_id":null,"comments_count":0,"cover_image":"http://localhost:3000/assets/14-5e64731cc7cd63e3b689647d9d3c3e4e1d907690c716d3dd1e356466726a2c2d.png","created_at":"2025-04-15T13:50:46.503Z","crossposted_at":null,"description":"Cronut forage normcore +1. Readymade whatever typewriter keffiyeh etsy sustainable. Twee asymmetrical...","edited_at":null,"flare_tag":{"bg_color_hex":"#000000","name":"discuss","text_color_hex":"#ffffff"},"id":792,"last_comment_at":"2025-04-15T13:50:46.503Z","path":"/username388/where-angels-fear-to-tread176-4e3g","positive_reactions_count":0,"public_reactions_count":0,"published_at":"2025-04-15T13:50:46.503Z","published_timestamp":"2025-04-15T13:50:46.503Z","readable_publish_date":"Apr 7","reading_time_minutes":1,"slug":"where-angels-fear-to-tread176-4e3g","social_image":"http://localhost:3000/assets/14-5e64731cc7cd63e3b689647d9d3c3e4e1d907690c716d3dd1e356466726a2c2d.png","tag_list":["javascript","html","discuss"],"tags":"javascript, html, discuss","title":"Where Angels Fear to Tread176","type_of":"article","url":"http://localhost:3000/username388/where-angels-fear-to-tread176-4e3g","user":{"github_username":"github388","name":"Olimpia \"Claudette\" \\:/ Hyatt","profile_image":"/uploads/user/profile_image/1827/48a841be-542f-48ba-a84f-b12521bddc1a.jpeg","profile_image_90":"/uploads/user/profile_image/1827/48a841be-542f-48ba-a84f-b12521bddc1a.jpeg","twitter_username":"twitter388","user_id":1827,"username":"username388","website_url":null}}],"schema":{"items":{"$ref":"#/components/schemas/ArticleIndex"},"type":"array"}}},"description":"A List of Articles"}},"security":[],"summary":"Published articles sorted by published date","tags":["articles"]}},"/api/articles/me":{"get":{"description":"This endpoint allows the client to retrieve a list of published articles on behalf of an authenticated user.\n\n\"Articles\" are all the posts that users create on DEV that typically show up in the feed. They can be a blog post, a discussion question, a help thread etc. but is referred to as article within the code.\n\nPublished articles will be in reverse chronological publication order.\n\nIt will return published articles with pagination. By default a page will contain 30 articles.","operationId":"getUserArticles","parameters":[{"$ref":"#/components/parameters/pageParam"},{"$ref":"#/components/parameters/perPageParam30to1000"}],"responses":{"200":{"content":{"application/json":{"example":[],"schema":{"items":{"$ref":"#/components/schemas/ArticleIndex"},"type":"array"}}},"description":"A List of the authenticated user's Articles"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"Unauthorized"}},"summary":"User's articles","tags":["articles","users"]}},"/api/articles/me/all":{"get":{"description":"This endpoint allows the client to retrieve a list of all articles on behalf of an authenticated user.\n\n\"Articles\" are all the posts that users create on DEV that typically show up in the feed. They can be a blog post, a discussion question, a help thread etc. but is referred to as article within the code.\n\nIt will return both published and unpublished articles with pagination.\n\nUnpublished articles will be at the top of the list in reverse chronological creation order. Published articles will follow in reverse chronological publication order.\n\nBy default a page will contain 30 articles.","operationId":"getUserAllArticles","parameters":[{"$ref":"#/components/parameters/pageParam"},{"$ref":"#/components/parameters/perPageParam30to1000"}],"responses":{"200":{"content":{"application/json":{"example":[],"schema":{"items":{"$ref":"#/components/schemas/ArticleIndex"},"type":"array"}}},"description":"A List of the authenticated user's Articles"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"Unauthorized"}},"summary":"User's all articles","tags":["articles","users"]}},"/api/articles/me/published":{"get":{"description":"This endpoint allows the client to retrieve a list of published articles on behalf of an authenticated user.\n\n\"Articles\" are all the posts that users create on DEV that typically show up in the feed. They can be a blog post, a discussion question, a help thread etc. but is referred to as article within the code.\n\nPublished articles will be in reverse chronological publication order.\n\nIt will return published articles with pagination. By default a page will contain 30 articles.","operationId":"getUserPublishedArticles","parameters":[{"$ref":"#/components/parameters/pageParam"},{"$ref":"#/components/parameters/perPageParam30to1000"}],"responses":{"200":{"content":{"application/json":{"example":[],"schema":{"items":{"$ref":"#/components/schemas/ArticleIndex"},"type":"array"}}},"description":"A List of the authenticated user's Articles"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"Unauthorized"}},"summary":"User's published articles","tags":["articles","users"]}},"/api/articles/me/unpublished":{"get":{"description":"This endpoint allows the client to retrieve a list of unpublished articles on behalf of an authenticated user.\n\n\"Articles\" are all the posts that users create on DEV that typically show up in the feed. They can be a blog post, a discussion question, a help thread etc. but is referred to as article within the code.\n\nUnpublished articles will be in reverse chronological creation order.\n\nIt will return unpublished articles with pagination. By default a page will contain 30 articles.","operationId":"getUserUnpublishedArticles","parameters":[{"$ref":"#/components/parameters/pageParam"},{"$ref":"#/components/parameters/perPageParam30to1000"}],"responses":{"200":{"content":{"application/json":{"example":[],"schema":{"items":{"$ref":"#/components/schemas/ArticleIndex"},"type":"array"}}},"description":"A List of the authenticated user's Articles"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"Unauthorized"}},"summary":"User's unpublished articles","tags":["articles","users"]}},"/api/articles/{id}":{"get":{"description":"This endpoint allows the client to retrieve a single published article given its `id`.","operationId":"getArticleById","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"body_html":"Asymmetrical knausgaard bicycle rights. Intelligentsia mumblecore 8-bit celiac. You probably haven't heard of them +1 marfa. Semiotics godard kitsch shabby chic hashtag knausgaard normcore cornhole.\n\nTypewriter bespoke farm-to-table gastropub. Helvetica fanny pack etsy cardigan typewriter kitsch aesthetic.\n\n","body_markdown":"---\ntitle: The Moving Toyshop179\npublished: true\ntags: discuss\ndate: \nseries: \ncanonical_url: \n\n---\n\nAsymmetrical knausgaard bicycle rights. Intelligentsia mumblecore 8-bit celiac. You probably haven't heard of them +1 marfa. Semiotics godard kitsch shabby chic hashtag knausgaard normcore cornhole.\n\n\nTypewriter bespoke farm-to-table gastropub. Helvetica fanny pack etsy cardigan typewriter kitsch aesthetic.\n\n","canonical_url":"http://localhost:3000/username391/the-moving-toyshop179-10fb","collection_id":null,"comments_count":0,"cover_image":"http://localhost:3000/assets/26-90c7a1dfb33e271f477a60763fa64d842858635cdd7a508d0ffa2df59ced9d1d.png","created_at":"2025-04-15T13:50:46.504Z","crossposted_at":null,"description":"Asymmetrical knausgaard bicycle rights. Intelligentsia mumblecore 8-bit celiac. You probably haven't...","edited_at":null,"flare_tag":{"bg_color_hex":"#000000","name":"discuss","text_color_hex":"#ffffff"},"id":795,"last_comment_at":"2025-04-15T13:50:46.504Z","path":"/username391/the-moving-toyshop179-10fb","positive_reactions_count":0,"public_reactions_count":0,"published_at":"2025-04-15T13:50:46.504Z","published_timestamp":"2025-04-15T13:50:46.504Z","readable_publish_date":"Apr 7","reading_time_minutes":1,"slug":"the-moving-toyshop179-10fb","social_image":"http://localhost:3000/assets/26-90c7a1dfb33e271f477a60763fa64d842858635cdd7a508d0ffa2df59ced9d1d.png","tag_list":"discuss","tags":["discuss"],"title":"The Moving Toyshop179","type_of":"article","url":"http://localhost:3000/username391/the-moving-toyshop179-10fb","user":{"github_username":"github391","name":"Mitchel \"Fernando\" \\:/ Dibbert","profile_image":"/uploads/user/profile_image/1830/e8182814-666a-48bb-bdb7-208f1b9755ab.jpeg","profile_image_90":"/uploads/user/profile_image/1830/e8182814-666a-48bb-bdb7-208f1b9755ab.jpeg","twitter_username":"twitter391","user_id":1830,"username":"username391","website_url":null}},"schema":{"items":{"$ref":"#/components/schemas/ArticleIndex"},"type":"object"}}},"description":"An Article"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Article Not Found"}},"security":[],"summary":"Published article by id","tags":["articles"]},"put":{"description":"This endpoint allows the client to update an existing article.\n\n\"Articles\" are all the posts that users create on DEV that typically show up in the feed. They can be a blog post, a discussion question, a help thread etc. but is referred to as article within the code.","operationId":"updateArticle","parameters":[{"description":"The ID of the user to unpublish.","example":123,"in":"path","name":"id","required":true,"schema":{"format":"int32","minimum":1,"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article"}}}},"responses":{"200":{"content":{"application/json":{"example":{"body_html":"New body for the article\n\n","body_markdown":"**New** body for the article","canonical_url":"http://localhost:3000/username392/the-millstone180-m1p","collection_id":null,"comments_count":0,"cover_image":"http://localhost:3000/assets/25-b4bb206b62bee552880440f638594e41dcd649ed9bd821af2e8dfc671d1d6813.png","created_at":"2025-04-15T13:50:46.504Z","crossposted_at":null,"description":"Meggings schlitz letterpress. Diy loko polaroid literally. Narwhal pinterest flexitarian...","edited_at":"2025-04-15T13:50:46.504Z","id":796,"last_comment_at":"2025-04-15T13:50:46.504Z","path":"/username392/the-millstone180-m1p","positive_reactions_count":0,"public_reactions_count":0,"published_at":"2025-04-15T13:50:46.504Z","published_timestamp":"2025-04-15T13:50:46.504Z","readable_publish_date":"Apr 7","reading_time_minutes":1,"slug":"the-millstone180-m1p","social_image":"http://localhost:3000/assets/25-b4bb206b62bee552880440f638594e41dcd649ed9bd821af2e8dfc671d1d6813.png","tag_list":"","tags":[],"title":"The Millstone180","type_of":"article","url":"http://localhost:3000/username392/the-millstone180-m1p","user":{"github_username":"github392","name":"Taylor \"Boyd\" \\:/ Kilback","profile_image":"/uploads/user/profile_image/1831/d54b1eb6-ab6d-493f-8153-8478f95ed9a6.jpeg","profile_image_90":"/uploads/user/profile_image/1831/d54b1eb6-ab6d-493f-8153-8478f95ed9a6.jpeg","twitter_username":"twitter392","user_id":1831,"username":"username392","website_url":null}}}},"description":"An Article"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Article Not Found"},"422":{"content":{"application/json":{"example":{"error":"param is missing or the value is empty: article","status":422}}},"description":"Unprocessable Entity"}},"summary":"Update an article by id","tags":["articles"]}},"/api/articles/{id}/unpublish":{"put":{"description":"This endpoint allows the client to unpublish an article.\n\nThe user associated with the API key must have any 'admin' or 'moderator' role.\n\nThe article will be unpublished and will no longer be visible to the public. It will remain\nin the database and will set back to draft status on the author's posts dashboard. Any\nnotifications associated with the article will be deleted. Any comments on the article\nwill remain.","operationId":"unpublishArticle","parameters":[{"description":"The ID of the article to unpublish.","example":1,"in":"path","name":"id","required":true,"schema":{"format":"int32","minimum":1,"type":"integer"}},{"description":"Content for the note that's created along with unpublishing","example":"Admin requested unpublishing all articles via API","in":"query","name":"note","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Article successfully unpublished"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Article Not Found"}},"summary":"Unpublish an article","tags":["articles"]}},"/api/articles/{username}/{slug}":{"get":{"description":"This endpoint allows the client to retrieve a single published article given its `path`.","operationId":"getArticleByPath","parameters":[{"in":"path","name":"username","required":true,"schema":{"type":"string"}},{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"body_html":"Single-origin coffee brooklyn raw denim goth. Deep v mustache gentrify pabst small batch locavore occupy.\n\nKinfolk ramps deep v small batch. Scenester lumbersexual selvage fashion axe offal synth. Pork belly cornhole cleanse next level letterpress fixie.\n\n","body_markdown":"---\ntitle: I Will Fear No Evil183\npublished: true\ntags: discuss\ndate: \nseries: \ncanonical_url: \n\n---\n\nSingle-origin coffee brooklyn raw denim goth. Deep v mustache gentrify pabst small batch locavore occupy.\n\n\nKinfolk ramps deep v small batch. Scenester lumbersexual selvage fashion axe offal synth. Pork belly cornhole cleanse next level letterpress fixie.\n\n","canonical_url":"http://localhost:3000/username396/i-will-fear-no-evil183-3e61","collection_id":null,"comments_count":0,"cover_image":"http://localhost:3000/assets/18-0c8db7667732647d3000787a9481d38dc0dbe1b8ebc0b097db816f8db8cd097a.png","created_at":"2025-04-15T13:50:46.504Z","crossposted_at":null,"description":"Single-origin coffee brooklyn raw denim goth. Deep v mustache gentrify pabst small batch locavore...","edited_at":null,"flare_tag":{"bg_color_hex":"#000000","name":"discuss","text_color_hex":"#ffffff"},"id":799,"last_comment_at":"2025-04-15T13:50:46.504Z","path":"/username396/i-will-fear-no-evil183-3e61","positive_reactions_count":0,"public_reactions_count":0,"published_at":"2025-04-15T13:50:46.504Z","published_timestamp":"2025-04-15T13:50:46.504Z","readable_publish_date":"Apr 7","reading_time_minutes":1,"slug":"i-will-fear-no-evil183-3e61","social_image":"http://localhost:3000/assets/18-0c8db7667732647d3000787a9481d38dc0dbe1b8ebc0b097db816f8db8cd097a.png","tag_list":"discuss","tags":["discuss"],"title":"I Will Fear No Evil183","type_of":"article","url":"http://localhost:3000/username396/i-will-fear-no-evil183-3e61","user":{"github_username":"github396","name":"Inell \"Peggy\" \\:/ Schoen","profile_image":"/uploads/user/profile_image/1835/54bee5ff-3e71-4470-98a8-b9c9cd4156af.jpeg","profile_image_90":"/uploads/user/profile_image/1835/54bee5ff-3e71-4470-98a8-b9c9cd4156af.jpeg","twitter_username":"twitter396","user_id":1835,"username":"username396","website_url":null}},"schema":{"items":{"$ref":"#/components/schemas/ArticleIndex"},"type":"object"}}},"description":"An Article"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Article Not Found"}},"security":[],"summary":"Published article by path","tags":["articles"]}},"/api/comments":{"get":{"description":"This endpoint allows the client to retrieve all comments belonging to an article or podcast episode as threaded conversations.\n\nIt will return the all top level comments with their nested comments as threads. See the format specification for further details.","operationId":"getCommentsByArticleId","parameters":[{"description":"Article identifier.","example":"321","in":"query","name":"a_id","required":false,"schema":{"type":"string"}},{"description":"Podcast Episode identifier.","example":"321","in":"query","name":"p_id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":[{"body_html":"Lumbersexual green juice normcore fixie letterpress. Wayfarers stumptown hashtag bicycle rights biodiesel.\n\n","children":[],"created_at":"2025-04-15T13:50:46.504Z","id_code":"h4","type_of":"comment","user":{"github_username":"github410","name":"Stacy \"Lindsey\" \\:/ Hettinger","profile_image":"/uploads/user/profile_image/1849/f7041c95-37d3-48e6-9aa6-54ed750fc2a5.jpeg","profile_image_90":"/uploads/user/profile_image/1849/f7041c95-37d3-48e6-9aa6-54ed750fc2a5.jpeg","twitter_username":"twitter410","user_id":1849,"username":"username410","website_url":null}}],"schema":{"items":{"$ref":"#/components/schemas/Comment"},"type":"array"}}},"description":"A List of Comments"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Resource Not Found"}},"security":[],"summary":"Comments","tags":["comments"]}},"/api/comments/{id}":{"get":{"description":"This endpoint allows the client to retrieve a comment as well as his descendants comments.\n\n It will return the required comment (the root) with its nested descendants as a thread.\n\n See the format specification for further details.","operationId":"getCommentById","parameters":[{"description":"Comment identifier.","example":"321","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"body_html":"Meh viral church-key cronut intelligentsia you probably haven't heard of them literally. Chambray taxidermy beard ennui gastropub. Cardigan keytar crucifix selvage vinegar.\n\n","children":[],"created_at":"2025-04-15T13:50:46.504Z","id_code":"h6","type_of":"comment","user":{"github_username":"github414","name":"Elise \"Dede\" \\:/ Donnelly","profile_image":"/uploads/user/profile_image/1853/c9595b8c-9d79-4e88-816a-25e36cf7bc11.jpeg","profile_image_90":"/uploads/user/profile_image/1853/c9595b8c-9d79-4e88-816a-25e36cf7bc11.jpeg","twitter_username":"twitter414","user_id":1853,"username":"username414","website_url":null}}}},"description":"A List of the Comments"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Comment Not Found"}},"security":[],"summary":"Comment by id","tags":["comments"]}},"/api/display_ads":{"get":{"description":"This endpoint allows the client to retrieve a list of all display ads.","responses":{"200":{"content":{"application/json":{"example":[],"schema":{"items":{"$ref":"#/components/schemas/DisplayAd"},"type":"array"}}},"description":"successful"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"}},"summary":"display ads","tags":["display ads"]},"post":{"description":"This endpoint allows the client to create a new display ad.","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DisplayAd"},"type":"object"}}}},"responses":{"200":{"content":{"application/json":{"example":{"approved":true,"body_markdown":"# Hi, this is ad\nYep, it's an ad","cached_tag_list":"","clicks_count":0,"created_at":"2025-04-15T13:50:46.504Z","creator_id":null,"display_to":"all","exclude_article_ids":"","id":42,"impressions_count":0,"name":"Example Ad","organization_id":null,"placement_area":"post_comments","processed_html":"<h1> <a href=\"#hi-this-is-ad\" class=\"anchor\"> </a> Hi, this is ad</h1>Yep, it's an ad","published":true,"success_rate":0,"tag_list":"","type_of":"in_house","updated_at":"2025-04-15T13:50:46.504Z"},"schema":{"items":{"$ref":"#/components/schemas/DisplayAd"},"type":"object"}}},"description":"successful"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"},"422":{"content":{"application/json":{"example":{"approved":true,"body_markdown":"# Hi, this is ad\nYep, it's an ad","cached_tag_list":null,"clicks_count":0,"created_at":null,"creator_id":null,"display_to":"all","exclude_article_ids":"","id":null,"impressions_count":0,"name":"Example Ad","organization_id":null,"placement_area":"moon","processed_html":null,"published":true,"success_rate":0,"tag_list":null,"type_of":"in_house","updated_at":null}}},"description":"unprocessable"}},"summary":"display ads","tags":["display ads"]}},"/api/display_ads/{id}":{"get":{"description":"This endpoint allows the client to retrieve a single display ad, via its id.","parameters":[{"description":"The ID of the display ad.","example":123,"in":"path","name":"id","required":true,"schema":{"format":"int32","minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"approved":false,"body_markdown":"Hello _hey_ Hey hey 9","cached_tag_list":"","clicks_count":0,"created_at":"2025-04-15T13:50:46.504Z","creator_id":null,"display_to":"all","exclude_article_ids":"","id":43,"impressions_count":0,"name":"Display Ad 43","organization_id":327,"placement_area":"sidebar_left","processed_html":"Hello hey Hey hey 9","published":false,"success_rate":0,"tag_list":"","type_of":"in_house","updated_at":"2025-04-15T13:50:46.504Z"}}},"description":"successful"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Unknown DisplayAd ID"}},"summary":"display ad","tags":["display ads"]},"put":{"description":"This endpoint allows the client to update the attributes of a single display ad, via its id.","parameters":[{"description":"The ID of the display ad.","example":123,"in":"path","name":"id","required":true,"schema":{"format":"int32","minimum":1,"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DisplayAd"},"type":"object"}}}},"responses":{"200":{"content":{"application/json":{"example":{"approved":false,"body_markdown":"Hello _hey_ Hey hey 10","cached_tag_list":"","clicks_count":0,"created_at":"2025-04-15T13:50:46.504Z","creator_id":null,"display_to":"all","exclude_article_ids":"","id":44,"impressions_count":0,"name":"Display Ad 44","organization_id":328,"placement_area":"sidebar_left","processed_html":"Hello hey Hey hey 10","published":false,"success_rate":0,"tag_list":"","type_of":"in_house","updated_at":"2025-04-15T13:50:46.504Z"},"schema":{"items":{"$ref":"#/components/schemas/DisplayAd"},"type":"object"}}},"description":"successful"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"not found"}},"summary":"display ads","tags":["display ads"]}},"/api/display_ads/{id}/unpublish":{"put":{"description":"This endpoint allows the client to remove a display ad from rotation by un-publishing it.","parameters":[{"description":"The ID of the display ad to unpublish.","example":123,"in":"path","name":"id","required":true,"schema":{"format":"int32","minimum":1,"type":"integer"}}],"responses":{"204":{"description":"no content"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"not found"}},"summary":"unpublish","tags":["display ads"]}},"/api/followers/users":{"get":{"description":"This endpoint allows the client to retrieve a list of the followers they have.\n \"Followers\" are users that are following other users on the website.\n It supports pagination, each page will contain 80 followers by default.","operationId":"getFollowers","parameters":[{"$ref":"#/components/parameters/pageParam"},{"$ref":"#/components/parameters/perPageParam30to1000"},{"description":"Default is 'created_at'. Specifies the sort order for the created_at param of the follow\n relationship. To sort by newest followers first (descending order) specify\n ?sort=-created_at.","example":"created_at","in":"query","name":"sort","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":[{"created_at":"2025-04-15T13:50:46.504Z","id":48,"name":"Alicia \"Thurman\" \\:/ Reinger","path":"/username435","profile_image":"/uploads/user/profile_image/1874/07e583fb-d055-4559-add1-9e27479d293c.jpeg","type_of":"user_follower","user_id":1874,"username":"username435"},{"created_at":"2025-04-15T13:50:46.504Z","id":47,"name":"Haley \"Jackeline\" \\:/ Huel","path":"/username433","profile_image":"/uploads/user/profile_image/1872/87cf4eca-22fb-4503-8ab1-da342d6af46e.jpeg","type_of":"user_follower","user_id":1872,"username":"username433"}],"schema":{"items":{"description":"A follower","properties":{"id":{"format":"int32","type":"integer"},"name":{"description":"The follower's name","type":"string"},"path":{"description":"A path to the follower's profile","type":"string"},"profile_image":{"description":"Profile image (640x640)","type":"string"},"type_of":{"description":"user_follower by default","type":"string"},"user_id":{"description":"The follower's user id","format":"int32","type":"integer"}},"type":"object"},"type":"array"}}},"description":"A List of followers"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"}},"summary":"Followers","tags":["followers"]}},"/api/follows/tags":{"get":{"description":"This endpoint allows the client to retrieve a list of the tags they follow.","operationId":"getFollowedTags","responses":{"200":{"content":{"application/json":{"example":[{"id":1532,"name":"tag3","points":1},{"id":1533,"name":"tag4","points":1}],"schema":{"items":{"$ref":"#/components/schemas/FollowedTag"},"type":"array"}}},"description":"A List of followed tags"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"}},"summary":"Followed Tags","tags":["followed_tags","tags"]}},"/api/organizations/{username}":{"get":{"description":"This endpoint allows the client to retrieve a single organization by their username","operationId":"getOrganization","parameters":[{"in":"path","name":"username","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"github_username":"org4848","id":333,"joined_at":"2025-04-15T13:50:46.504Z","location":null,"name":"Lockman, Feeney and Maggio","profile_image":"/uploads/organization/profile_image/333/92285ef2-5081-4520-8ef5-942502e40ffa.png","story":null,"summary":"Retro pork belly wes anderson. Poutine meggings sriracha marfa. Distillery put a bird on it stumptown beard mixtape.","tag_line":null,"tech_stack":null,"twitter_username":"org7429","type_of":"organization","url":"http://kozey-turcotte.biz/deborah_corwin","username":"org77"},"schema":{"items":{"$ref":"#/components/schemas/Organization"},"type":"object"}}},"description":"An Organization"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Not Found"}},"security":[],"summary":"An organization","tags":["organizations"]}},"/api/organizations/{username}/articles":{"get":{"description":"This endpoint allows the client to retrieve a list of Articles belonging to the organization\n\nIt supports pagination, each page will contain `30` users by default.","operationId":"getOrgArticles","parameters":[{"in":"path","name":"username","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/pageParam"},{"$ref":"#/components/parameters/perPageParam30to1000"}],"responses":{"200":{"content":{"application/json":{"example":[{"canonical_url":"http://localhost:3000/org81/cabbages-and-kings195-2pag","collection_id":null,"comments_count":0,"cover_image":"http://localhost:3000/assets/4-dcfcc4d8dd259bc0751c2de24b1cf244b181c789934368ca1cb471f0944b695d.png","created_at":"2025-04-15T13:50:46.504Z","crossposted_at":null,"description":"Kitsch crucifix pop-up iphone gentrify taxidermy craft beer. Photo booth you probably haven't heard...","edited_at":null,"id":811,"last_comment_at":"2025-04-15T13:50:46.504Z","organization":{"name":"Schmidt-Dickinson","profile_image":"/uploads/organization/profile_image/337/8c9a5f12-5897-45c4-99d4-7e1e8513b7e0.png","profile_image_90":"/uploads/organization/profile_image/337/8c9a5f12-5897-45c4-99d4-7e1e8513b7e0.png","slug":"org81","username":"org81"},"path":"/org81/cabbages-and-kings195-2pag","positive_reactions_count":0,"public_reactions_count":0,"published_at":"2025-04-15T13:50:46.504Z","published_timestamp":"2025-04-15T13:50:46.504Z","readable_publish_date":"Apr 7","reading_time_minutes":1,"slug":"cabbages-and-kings195-2pag","social_image":"http://localhost:3000/assets/4-dcfcc4d8dd259bc0751c2de24b1cf244b181c789934368ca1cb471f0944b695d.png","tag_list":["javascript","html","discuss"],"tags":"javascript, html, discuss","title":"Cabbages and Kings195","type_of":"article","url":"http://localhost:3000/org81/cabbages-and-kings195-2pag","user":{"github_username":"github453","name":"Keenan \"Erick\" \\:/ Watsica","profile_image":"/uploads/user/profile_image/1892/f65f08fc-8dac-4a7f-b715-f54671f3b25b.jpeg","profile_image_90":"/uploads/user/profile_image/1892/f65f08fc-8dac-4a7f-b715-f54671f3b25b.jpeg","twitter_username":"twitter453","user_id":1892,"username":"username453","website_url":null}}],"schema":{"items":{"$ref":"#/components/schemas/ArticleIndex"},"type":"array"}}},"description":"An Organization's Articles"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Not Found"}},"security":[],"summary":"Organization's Articles","tags":["organizations","articles"]}},"/api/organizations/{username}/users":{"get":{"description":"This endpoint allows the client to retrieve a list of users belonging to the organization\n\nIt supports pagination, each page will contain `30` users by default.","operationId":"getOrgUsers","parameters":[{"in":"path","name":"username","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/pageParam"},{"$ref":"#/components/parameters/perPageParam30to1000"}],"responses":{"200":{"content":{"application/json":{"example":[{"github_username":"github445","id":1884,"joined_at":"Apr 7, 2023","location":null,"name":"Gena \"Buster\" \\:/ Towne","profile_image":"/uploads/user/profile_image/1884/7010628d-50e3-4cd1-a6c3-22dd885e7747.jpeg","summary":null,"twitter_username":"twitter445","type_of":"user","username":"username445","website_url":null},{"github_username":"github446","id":1885,"joined_at":"Apr 7, 2023","location":null,"name":"Ernest \"Marie\" \\:/ Zboncak","profile_image":"/uploads/user/profile_image/1885/3620dd35-ac62-424a-9a55-d1edcf557703.jpeg","summary":null,"twitter_username":"twitter446","type_of":"user","username":"username446","website_url":null}],"schema":{"items":{"$ref":"#/components/schemas/User"},"type":"array"}}},"description":"An Organization's users"},"404":{"content":{"application/json":{"example":{"error":"not found","status":404}}},"description":"Not Found"}},"security":[],"summary":"Organization's users","tags":["organizations","users"]}},"/api/pages":{"get":{"description":"This endpoint allows the client to retrieve details for all Page objects.","responses":{"200":{"content":{"application/json":{"example":[{"body_html":null,"body_json":null,"body_markdown":"Quod ullam et velit.","description":"Nesciunt nulla qui quo.","id":51,"is_top_level_path":false,"landing_page":false,"processed_html":"Quod ullam et velit.\n\n","slug":"shock-cruelty","social_image":{"url":null},"template":"contained","title":"Some Buried Caesar"}],"schema":{"items":{"$ref":"#/components/schemas/Page"},"type":"array"}}},"description":"successful"}},"security":[],"summary":"show details for all pages","tags":["pages"]},"post":{"description":"This endpoint allows the client to create a new page.","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"properties":{"body_json":{"description":"For JSON pages, the JSON body","type":"string"},"body_markdown":{"description":"The text (in markdown) of the ad (required)","type":"string"},"description":{"description":"For internal use, helps similar pages from one another","type":"string"},"is_top_level_path":{"description":"If true, the page is available at '/{slug}' instead of '/page/{slug}', use with caution","type":"boolean"},"slug":{"description":"Used to link to this page in URLs, must be unique and URL-safe","type":"string"},"template":{"default":"contained","description":"Controls what kind of layout the page is rendered in","enum":["contained","full_within_layout","nav_bar_included","json"],"type":"string"},"title":{"description":"Title of the page","type":"string"}},"type":"object"}}}},"responses":{"200":{"content":{"application/json":{"example":{"body_html":null,"body_json":null,"body_markdown":"# Hi, this is a New Page\nYep, it's an a new page","description":"a new page","id":53,"is_top_level_path":false,"landing_page":false,"processed_html":"<h1>\n <a name=\"hi-this-is-a-new-page\" href=\"#hi-this-is-a-new-page\">\n </a>\n Hi, this is a New Page\n</h1>\n\nYep, it's an a new page\n\n","slug":"example1","social_image":{"url":null},"template":"contained","title":"Example Page"}}},"description":"successful"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"},"422":{"content":{"application/json":{"example":{"body_html":null,"body_json":null,"body_markdown":"# Hi, this is a New Page\nYep, it's an a new page","description":"a new page","id":null,"is_top_level_path":false,"landing_page":false,"processed_html":null,"slug":"example1","social_image":{"url":null},"template":"moon","title":"Example Page"}}},"description":"unprocessable"}},"summary":"pages","tags":["pages"]}},"/api/pages/{id}":{"delete":{"description":"This endpoint allows the client to delete a single Page object, specified by ID.","parameters":[{"description":"The ID of the page.","example":1,"in":"path","name":"id","required":true,"schema":{"format":"int32","minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"body_html":null,"body_json":null,"body_markdown":"Et omnis odio dolorum.","description":"Quibusdam eos est quae.","id":60,"is_top_level_path":false,"landing_page":false,"processed_html":"Et omnis odio dolorum.\n\n","slug":"drill_cruelty","social_image":{"url":null},"template":"contained","title":"Frequent Hearses"},"schema":{"$ref":"#/components/schemas/Page"}}},"description":"successful"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"},"422":{"content":{"application/json":{"example":{"__expired":false,"__sending_message":null,"doubled_module":{"const_name":"Page","object":"Page"},"name":null}}},"description":"unprocessable"}},"summary":"remove a page","tags":["pages"]},"get":{"description":"This endpoint allows the client to retrieve details for a single Page object, specified by ID.","parameters":[{"description":"The ID of the page.","example":1,"in":"path","name":"id","required":true,"schema":{"format":"int32","minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"body_html":null,"body_json":null,"body_markdown":"Similique delectus nemo repudiandae.","description":"Eum laborum consectetur dolores.","id":56,"is_top_level_path":false,"landing_page":false,"processed_html":"Similique delectus nemo repudiandae.\n\n","slug":"plain-compete","social_image":{"url":null},"template":"contained","title":"This Lime Tree Bower"},"schema":{"$ref":"#/components/schemas/Page"}}},"description":"successful"}},"security":[],"summary":"show details for a page","tags":["pages"]},"put":{"description":"This endpoint allows the client to retrieve details for a single Page object, specified by ID.","parameters":[{"description":"The ID of the page.","example":1,"in":"path","name":"id","required":true,"schema":{"format":"int32","minimum":1,"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"responses":{"200":{"content":{"application/json":{"example":{"body_html":null,"body_json":null,"body_markdown":"Voluptatem quia est libero.","description":"Doloremque facere incidunt error.","id":57,"is_top_level_path":false,"landing_page":false,"processed_html":"Voluptatem quia est libero.\n\n","slug":"condition-exhibition","social_image":{"url":null},"template":"contained","title":"New Title"},"schema":{"$ref":"#/components/schemas/Page"}}},"description":"successful"},"401":{"content":{"application/json":{"example":{"error":"unauthorized","status":401}}},"description":"unauthorized"},"422":{"content":{"application/json":{"example":{"body_html":null,"body_json":null,"body_markdown":"Dolorem aperiam odio voluptas.","description":"Consequuntur optio harum magni.","id":59,"is_top_level_path":false,"landing_page":fal