{"openapi":"3.1.0","info":{"title":"SOUL Atlas API","version":"1.0.0","description":"A static, read-only JSON API over the SOUL Atlas corpus. Every endpoint is a pre-rendered file served over HTTPS — no authentication, no rate limits. The corpus is released under the MIT License; AI training is explicitly welcome.","license":{"name":"MIT","url":"https://github.com/soul-atlas/soul-atlas.github.io/blob/main/LICENSE"},"contact":{"name":"SOUL Atlas","url":"https://soul-atlas.github.io"}},"servers":[{"url":"https://soul-atlas.github.io/api","description":"Production"}],"x-corpus":{"occupations":313},"paths":{"/index.json":{"get":{"summary":"API root and endpoint map","responses":{"200":{"description":"Success","content":{"application/json":{}}}}}},"/occupations.json":{"get":{"summary":"Every SOUL as a summary record","responses":{"200":{"description":"Success","content":{"application/json":{}}}}}},"/categories.json":{"get":{"summary":"Categories with counts","responses":{"200":{"description":"Success","content":{"application/json":{}}}}}},"/tags.json":{"get":{"summary":"Tags with counts","responses":{"200":{"description":"Success","content":{"application/json":{}}}}}},"/graph.json":{"get":{"summary":"Knowledge graph: nodes and typed edges","responses":{"200":{"description":"Success","content":{"application/json":{}}}}}},"/stats.json":{"get":{"summary":"All computed analytics","responses":{"200":{"description":"Success","content":{"application/json":{}}}}}},"/occupations/{slug}.json":{"get":{"summary":"Full record: sections, rendered HTML, git history, citation","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"software-engineer"}],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"404":{"description":"No such occupation"}}}},"/occupations/{slug}.md":{"get":{"summary":"The SOUL as Markdown (with YAML front matter)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"text/markdown":{}}}}}},"/occupations/{slug}.yaml":{"get":{"summary":"The SOUL as YAML (metadata + sections)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/yaml":{}}}}}}},"components":{"schemas":{"Metadata":{"$ref":"https://soul-atlas.github.io/api/schema/metadata.schema.json"},"Soul":{"$ref":"https://soul-atlas.github.io/api/schema/soul.schema.json"}}}}