{"openapi":"3.1.0","info":{"title":"hdoc API","version":"1.0.0","description":"Publish AI-made HTML documents and slide decks as shareable hdoc URLs."},"servers":[{"url":"https://hdoc.docenty.ai/"}],"components":{"securitySchemes":{"hdocApiKey":{"type":"http","scheme":"bearer","description":"Create an API key at /account/keys."}},"schemas":{"PublishRequest":{"type":"object","required":["html"],"properties":{"html":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"tags":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"promptNote":{"type":"string"},"sourceLabel":{"type":"string"},"password":{"type":"string"},"expirationDays":{"type":"number"}}}}},"security":[{"hdocApiKey":[]}],"paths":{"/api/v1/publish":{"post":{"summary":"Publish HTML","description":"Publish a self-contained HTML document or slide deck.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishRequest"}}}},"responses":{"200":{"description":"Published artifact with shareUrl and renderUrl."},"400":{"description":"Invalid HTML payload."},"401":{"description":"Missing or invalid API key."}}}},"/api/v1/artifacts":{"get":{"summary":"List artifacts","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"number","minimum":1,"maximum":50}}],"responses":{"200":{"description":"List of owned artifacts."},"401":{"description":"Missing or invalid API key."}}}},"/api/v1/content/search":{"get":{"summary":"Search approved content","description":"Search approved artifacts owned by this API key. Results are bounded summaries for agent retrieval.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Authorized approved content."}}}},"/api/v1/collections":{"get":{"summary":"List collections","responses":{"200":{"description":"Owned collections."}}},"post":{"summary":"Create collection","responses":{"201":{"description":"Created collection."}}}},"/api/v1/templates":{"get":{"summary":"List templates","responses":{"200":{"description":"Owned approved templates."}}},"post":{"summary":"Create template from approved artifact","responses":{"201":{"description":"Created template."}}}},"/api/v1/knowledge-packages":{"get":{"summary":"List knowledge packages","responses":{"200":{"description":"Owned knowledge packages."}}},"post":{"summary":"Create knowledge package","responses":{"201":{"description":"Created package."}}}}}}