{"openapi":"3.1.0","info":{"title":"Absolute Smiles Bassendean Public Information API","version":"1.0.0","description":"Read-only public practice and page information. No authentication. Use /api/v1/agent/ for stable version 1. Unversioned endpoints remain compatible aliases. Breaking changes use a new major URL version; see /developers/ for the deprecation policy. Does not submit enquiries, confirm bookings or expose patient data."},"components":{"schemas":{"Error":{"type":"object","required":["error","code","message","instructions","status"],"properties":{"error":{"type":"string","description":"Compatibility alias for code"},"code":{"type":"string","description":"Machine-readable error code","examples":["invalid_input","not_found","method_not_allowed"]},"message":{"type":"string"},"instructions":{"type":"string","description":"Actionable recovery guidance and documentation links"},"status":{"type":"integer","minimum":400,"maximum":599}}}}},"servers":[{"url":"https://absolute-smiles-swart.vercel.app"}],"security":[],"externalDocs":{"description":"Developer documentation and MCP instructions","url":"https://absolute-smiles-swart.vercel.app/developers/"},"paths":{"/api/v1/agent/practice/":{"get":{"operationId":"getPracticeInfo","summary":"Get practice contact details","responses":{"200":{"description":"Public practice information","content":{"application/json":{"schema":{"type":"object","required":["name","telephone","email","address","canonicalUrl","contactUrl","bookingUrl","bookingNote"],"properties":{"name":{"type":"string"},"telephone":{"type":"string"},"email":{"type":"string","format":"email"},"address":{"type":"object","required":["@type","streetAddress","addressLocality","addressRegion","postalCode","addressCountry"],"properties":{"@type":{"const":"PostalAddress"},"streetAddress":{"type":"string"},"addressLocality":{"type":"string"},"addressRegion":{"type":"string"},"postalCode":{"type":"string"},"addressCountry":{"type":"string"}}},"canonicalUrl":{"type":"string"},"contactUrl":{"type":"string"},"bookingUrl":{"type":"string"},"bookingNote":{"type":"string"}}}}}},"405":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/practice/":{"get":{"operationId":"getPracticeInfoLegacy","summary":"Get practice contact details","responses":{"200":{"description":"Public practice information","content":{"application/json":{"schema":{"type":"object","required":["name","telephone","email","address","canonicalUrl","contactUrl","bookingUrl","bookingNote"],"properties":{"name":{"type":"string"},"telephone":{"type":"string"},"email":{"type":"string","format":"email"},"address":{"type":"object","required":["@type","streetAddress","addressLocality","addressRegion","postalCode","addressCountry"],"properties":{"@type":{"const":"PostalAddress"},"streetAddress":{"type":"string"},"addressLocality":{"type":"string"},"addressRegion":{"type":"string"},"postalCode":{"type":"string"},"addressCountry":{"type":"string"}}},"canonicalUrl":{"type":"string"},"contactUrl":{"type":"string"},"bookingUrl":{"type":"string"},"bookingNote":{"type":"string"}}}}}},"405":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Compatibility alias for the version 1 endpoint. Existing clients remain supported."}},"/api/v1/agent/search/":{"get":{"operationId":"searchPages","summary":"Search published page titles and descriptions","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":120},"description":"Whitespace-trimmed search terms."}],"responses":{"200":{"description":"At most 10 matching pages","content":{"application/json":{"schema":{"type":"object","required":["pages"],"properties":{"pages":{"type":"array","maxItems":10,"items":{"type":"object","required":["path","title","description","canonical","url"],"properties":{"path":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"canonical":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"}}}}}}}}},"400":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/search/":{"get":{"operationId":"searchPagesLegacy","summary":"Search published page titles and descriptions","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":120},"description":"Whitespace-trimmed search terms."}],"responses":{"200":{"description":"At most 10 matching pages","content":{"application/json":{"schema":{"type":"object","required":["pages"],"properties":{"pages":{"type":"array","maxItems":10,"items":{"type":"object","required":["path","title","description","canonical","url"],"properties":{"path":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"canonical":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"}}}}}}}}},"400":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Compatibility alias for the version 1 endpoint. Existing clients remain supported."}},"/api/v1/agent/content/":{"get":{"operationId":"getPage","summary":"Read a published page as Markdown","parameters":[{"name":"path","in":"query","required":true,"description":"Site-relative page path without query, fragment, whitespace, backslash or dot segments.","schema":{"type":"string","maxLength":300,"pattern":"^/(?!/)","examples":["/contact-us/"]}}],"responses":{"200":{"description":"Published page and source URLs","content":{"application/json":{"schema":{"type":"object","required":["path","title","description","canonical","url","markdown","markdownUrl"],"properties":{"path":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"canonical":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"},"markdown":{"type":"string"},"markdownUrl":{"type":"string"}}}}}},"400":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/content/":{"get":{"operationId":"getPageLegacy","summary":"Read a published page as Markdown","parameters":[{"name":"path","in":"query","required":true,"description":"Site-relative page path without query, fragment, whitespace, backslash or dot segments.","schema":{"type":"string","maxLength":300,"pattern":"^/(?!/)","examples":["/contact-us/"]}}],"responses":{"200":{"description":"Published page and source URLs","content":{"application/json":{"schema":{"type":"object","required":["path","title","description","canonical","url","markdown","markdownUrl"],"properties":{"path":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"canonical":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"},"markdown":{"type":"string"},"markdownUrl":{"type":"string"}}}}}},"400":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Structured error with a machine-readable code and recovery instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Compatibility alias for the version 1 endpoint. Existing clients remain supported."}}}}