{"openapi":"3.1.0","info":{"title":"SOTA Design developer resources","summary":"Read-only HTTP interface for the SOTA Design website","description":"SOTA Design is a Taiwan digital design studio. We design connections between people, products, and public services — websites, brand systems, and the handoff from design to engineering. These endpoints describe the website — there is no authenticated product API.","version":"1.0.0","contact":{"name":"SOTA Design","email":"service@sota.design","url":"https://sota.design/contact/"}},"servers":[{"url":"https://sota.design","description":"Production"}],"paths":{"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Agent index (llms.txt)","responses":{"200":{"description":"Markdown index","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/":{"get":{"operationId":"getHome","summary":"Home HTML or Markdown via Accept","parameters":[{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"}}],"responses":{"200":{"description":"HTML by default; Markdown when Accept prefers text/markdown","headers":{"Vary":{"schema":{"type":"string","example":"Accept, Accept-Encoding"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","summary":"This OpenAPI document","responses":{"200":{"description":"OpenAPI JSON"}}}},"/rss.xml":{"get":{"operationId":"getRss","summary":"Blog RSS","responses":{"200":{"description":"RSS XML"}}}},"/sitemap.xml":{"get":{"operationId":"getSitemap","summary":"HTML sitemap","responses":{"200":{"description":"XML sitemap"}}}},"/agent-instructions.md":{"get":{"operationId":"getAgentInstructions","summary":"When-to-use instructions for agents","responses":{"200":{"description":"Markdown"}}}},"/api/v1/site":{"get":{"operationId":"getSite","summary":"Studio identity as JSON","responses":{"200":{"description":"Site identity","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"origin":{"type":"string"},"email":{"type":"string"},"description":{"type":"string"}}}}}},"default":{"description":"RFC 9457 problem details (JSON)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}},"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/posts":{"get":{"operationId":"listPosts","summary":"Blog post index as JSON","responses":{"200":{"description":"Post list","content":{"application/json":{"schema":{"type":"object","properties":{"posts":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"date":{"type":"string"},"tag":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"}}}}}}}}},"default":{"description":"RFC 9457 problem details (JSON)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}},"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/posts/{slug}":{"get":{"operationId":"getPost","summary":"Single blog post as JSON","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Post"},"404":{"description":"RFC 9457 problem details (JSON)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}},"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"RFC 9457 problem details (JSON)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}},"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"components":{"schemas":{"Problem":{"type":"object","required":["type","title","status","detail"],"properties":{"type":{"type":"string","format":"uri","description":"Stable error type URI with resolution hints"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"code":{"type":"string"},"hint":{"type":"string","description":"How an agent or client should recover"}}}}}}