{"openapi":"3.1.0","info":{"title":"Seba Agent API","version":"0.1.0","description":"Bounded, read-only REST API for public Seba discovery and citations."},"servers":[{"url":"https://api.seba.health"}],"paths":{"/v1/health":{"get":{"summary":"Health and snapshot metadata","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/search":{"get":{"summary":"Search public Seba records","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/citation-packets":{"get":{"summary":"Search source-backed Seba citation packets","parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Citation packets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/citation-packets/{id}":{"get":{"summary":"Fetch one citation packet by packet id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Citation packet","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/related-questions":{"get":{"summary":"Fetch related question fan-out from citation packets","parameters":[{"name":"packet_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"canonical_path","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Related questions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/fetch":{"get":{"summary":"Fetch one bounded record by stable id","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/terms":{"get":{"summary":"Search concordance terms","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Terms","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/terms/{slug}":{"get":{"summary":"Fetch a term summary","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Term","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/concordance/{slug}":{"get":{"summary":"Fetch capped concordance hits for a term","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Concordance term","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/passages/{slug}":{"get":{"summary":"Fetch a bounded passage record","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Passage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/pills/{slug}":{"get":{"summary":"Fetch a bounded pill record","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Pill","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/directory/search":{"get":{"summary":"Search public directory records","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"location","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Directory results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}},"/v1/citation-policy":{"get":{"summary":"Fetch API citation policy","responses":{"200":{"description":"Citation policy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiEnvelope"}}}}}}}},"components":{"schemas":{"ApiEnvelope":{"type":"object","required":["data","citations","links","meta"],"properties":{"data":{},"citations":{"type":"array","items":{"type":"object","required":["title","url","source_type"],"properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"source_type":{"enum":["pill","passage","term","directory","library","citation_packet","policy"]}}}},"links":{"type":"object","properties":{"canonical":{"type":"string","format":"uri"}}},"meta":{"type":"object","properties":{"api_version":{"const":"v1"}}}}}}}}