{"openapi":"3.1.0","info":{"title":"poe2k news API","version":"1.0.0","description":"Every published poe2k article: the overlay's releases, posts and announcements. Read-only, no auth; each endpoint is a static file the site's build writes."},"servers":[{"url":"https://poe2k.com"}],"paths":{"/api/news/all.json":{"get":{"operationId":"list_news","summary":"Every published article, newest first, also split by type","responses":{"200":{"description":"The articles","content":{"application/json":{"schema":{"type":"object","required":["articles","byType","meta"],"properties":{"articles":{"type":"array","items":{"$ref":"#/components/schemas/NewsItem"}},"byType":{"type":"object","properties":{"posts":{"type":"array","items":{"$ref":"#/components/schemas/NewsItem"}},"changelogs":{"type":"array","items":{"$ref":"#/components/schemas/NewsItem"}},"announcements":{"type":"array","items":{"$ref":"#/components/schemas/NewsItem"}}}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"posts":{"type":"integer"},"changelogs":{"type":"integer"},"announcements":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"}}}}}}}}}}},"/api/news/{folder}/{slug}.json":{"get":{"operationId":"get_news_article","summary":"One published article with its full text in Markdown; its address is the list's jsonUrl","parameters":[{"name":"folder","in":"path","required":true,"schema":{"type":"string"},"example":"changelog"},{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"v1-9-4"}],"responses":{"200":{"description":"The article","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/NewsItem"},{"type":"object","required":["content"],"properties":{"content":{"type":"object","properties":{"markdown":{"type":"string"}}}}}]}}}},"404":{"description":"No published article has that id"}}}}},"components":{"schemas":{"NewsItem":{"type":"object","required":["id","type","title","date","updated","platform","target","description","tags","jsonUrl"],"properties":{"id":{"type":"string","description":"The article's id, its folder and slug: changelog/v1-9-4"},"type":{"type":"string","enum":["changelog","post","announcement"]},"title":{"type":"string"},"date":{"type":"string","format":"date-time"},"updated":{"type":["string","null"],"format":"date-time"},"platform":{"type":"array","items":{"type":"string","enum":["web","app"]}},"target":{"description":"The app versions it is for: one version, a [min, max] range with open ends, or none","oneOf":[{"type":"string"},{"type":"array","prefixItems":[{"type":["string","null"]},{"type":["string","null"]}],"minItems":2,"maxItems":2},{"type":"null"}]},"description":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"version":{"type":"string","description":"A changelog's release"},"severity":{"type":"string","description":"An announcement's"},"jsonUrl":{"type":"string","description":"The article's own endpoint, with its full text"}}}}},"externalDocs":{"url":"https://poe2k.com/.well-known/agent-skills/poe2k/SKILL.md"}}