{"openapi":"3.1.0","info":{"title":"Ivan Peychev’s public archive","version":"1.0.0","description":"Read published English and Russian content. No authentication or model calls. Cite the canonical URL and preserve the author’s limitations and AI disclosures."},"servers":[{"url":"https://peycheff.com"}],"security":[],"paths":{"/api/agent/info":{"get":{"operationId":"site_info","summary":"Describe this public archive, its languages, limits and available interfaces.","parameters":[],"responses":{"200":{"description":"Published content","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"},"revision":{"type":"string"},"entries":{"type":"number"},"languages":{"type":"array","items":{"type":"string"}},"access":{"type":"string"},"search":{"type":"string"},"limits":{"type":"object","properties":{"query":{"type":"number"},"terms":{"type":"number"},"results":{"type":"number"},"body":{"type":"number"},"archive":{"type":"number"}},"required":["query","terms","results","body","archive"]},"interfaces":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["name","url","revision","entries","languages","access","search","limits","interfaces"]}}}},"304":{"description":"Unchanged, matching If-None-Match"},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"Invalid origin or host","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Entry not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Rate limit; retry after Retry-After seconds","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"503":{"description":"Archive unavailable; retry after Retry-After seconds","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/agent/entries":{"get":{"operationId":"list_entries","summary":"List published entries, newest first. Filter by language, kind or topic; use next_offset to paginate.","parameters":[{"name":"locale","in":"query","required":false,"schema":{"default":"en","type":"string","enum":["en","ru"]}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["note","essay","track","find","project","photo","now","research","page"]}},{"name":"topic","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}}],"responses":{"200":{"description":"Published content","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"string"},"total":{"type":"number"},"offset":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"locale":{"type":"string","enum":["en","ru"]},"source_locale":{"type":"string","enum":["en","ru"]},"translation_pending":{"type":"boolean"},"kind":{"type":"string","enum":["note","essay","track","find","project","photo","now","research","page"]},"title":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"markdown_url":{"type":"string"},"published":{"type":["string","null"]},"updated":{"type":["string","null"]},"topics":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string"}},"content_hash":{"type":"string"}},"required":["slug","locale","source_locale","translation_pending","kind","title","description","url","markdown_url","published","updated","topics","sources","content_hash"]}},"next_offset":{"type":["number","null"]}},"required":["revision","total","offset","items","next_offset"]}}}},"304":{"description":"Unchanged, matching If-None-Match"},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"Invalid origin or host","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Entry not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Rate limit; retry after Retry-After seconds","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"503":{"description":"Archive unavailable; retry after Retry-After seconds","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/agent/search":{"get":{"operationId":"search_entries","summary":"Search published text for all query words. Exact words, no stemming or model inference. Returns metadata; read an entry for full context and citations.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"locale","in":"query","required":false,"schema":{"default":"en","type":"string","enum":["en","ru"]}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["note","essay","track","find","project","photo","now","research","page"]}},{"name":"topic","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}}],"responses":{"200":{"description":"Published content","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"string"},"total":{"type":"number"},"offset":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"locale":{"type":"string","enum":["en","ru"]},"source_locale":{"type":"string","enum":["en","ru"]},"translation_pending":{"type":"boolean"},"kind":{"type":"string","enum":["note","essay","track","find","project","photo","now","research","page"]},"title":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"markdown_url":{"type":"string"},"published":{"type":["string","null"]},"updated":{"type":["string","null"]},"topics":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string"}},"content_hash":{"type":"string"}},"required":["slug","locale","source_locale","translation_pending","kind","title","description","url","markdown_url","published","updated","topics","sources","content_hash"]}},"next_offset":{"type":["number","null"]},"query":{"type":"string"}},"required":["revision","total","offset","items","next_offset","query"]}}}},"304":{"description":"Unchanged, matching If-None-Match"},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"Invalid origin or host","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Entry not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Rate limit; retry after Retry-After seconds","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"503":{"description":"Archive unavailable; retry after Retry-After seconds","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/agent/entry":{"get":{"operationId":"read_entry","summary":"Read one published entry with full Markdown, canonical URL, content hash and source links. Choose en or ru; source_locale identifies translation fallback.","parameters":[{"name":"slug","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},{"name":"locale","in":"query","required":false,"schema":{"default":"en","type":"string","enum":["en","ru"]}}],"responses":{"200":{"description":"Published content","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"string"},"entry":{"type":"object","properties":{"slug":{"type":"string"},"locale":{"type":"string","enum":["en","ru"]},"source_locale":{"type":"string","enum":["en","ru"]},"translation_pending":{"type":"boolean"},"kind":{"type":"string","enum":["note","essay","track","find","project","photo","now","research","page"]},"title":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"markdown_url":{"type":"string"},"published":{"type":["string","null"]},"updated":{"type":["string","null"]},"topics":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string"}},"content_hash":{"type":"string"},"markdown":{"type":"string"}},"required":["slug","locale","source_locale","translation_pending","kind","title","description","url","markdown_url","published","updated","topics","sources","content_hash","markdown"]}},"required":["revision","entry"]}}}},"304":{"description":"Unchanged, matching If-None-Match"},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"Invalid origin or host","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Entry not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Rate limit; retry after Retry-After seconds","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"503":{"description":"Archive unavailable; retry after Retry-After seconds","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}}}}