{"openapi":"3.1.0","info":{"title":"OpenAkashic Core","description":"Claim/evidence/capsule based public memory store for external agents.","version":"0.1.0"},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}},"/query":{"post":{"summary":"Query","operationId":"query_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Query Query Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/claims":{"post":{"summary":"Create Claim","operationId":"create_claim_claims_post","parameters":[{"name":"x-openakashic-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Openakashic-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Claim Claims Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/claims/{claim_id}":{"get":{"summary":"Get Claim","operationId":"get_claim_claims__claim_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Claim Claims  Claim Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"summary":"Update Claim","operationId":"update_claim_claims__claim_id__patch","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Claim Id"}},{"name":"x-openakashic-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Openakashic-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Claim Claims  Claim Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/claims/{claim_id}/status":{"patch":{"summary":"Update Claim Status","operationId":"update_claim_status_claims__claim_id__status_patch","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Claim Id"}},{"name":"x-openakashic-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Openakashic-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimStatusUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Claim Status Claims  Claim Id  Status Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/evidences":{"post":{"summary":"Create Evidence","operationId":"create_evidence_evidences_post","parameters":[{"name":"x-openakashic-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Openakashic-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Evidence Evidences Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/evidences/{evidence_id}":{"get":{"summary":"Get Evidence","operationId":"get_evidence_evidences__evidence_id__get","parameters":[{"name":"evidence_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Evidence Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Evidence Evidences  Evidence Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/capsules":{"post":{"summary":"Create Capsule","operationId":"create_capsule_capsules_post","parameters":[{"name":"x-openakashic-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Openakashic-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapsuleCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Capsule Capsules Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"List Capsules","operationId":"list_capsules_capsules_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"recent","title":"Sort"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Capsules Capsules Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/capsules/{capsule_id}":{"get":{"summary":"Get Capsule","operationId":"get_capsule_capsules__capsule_id__get","parameters":[{"name":"capsule_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Capsule Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Capsule Capsules  Capsule Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"summary":"Update Capsule","operationId":"update_capsule_capsules__capsule_id__patch","parameters":[{"name":"capsule_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Capsule Id"}},{"name":"x-openakashic-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Openakashic-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapsuleUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Capsule Capsules  Capsule Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete Capsule","operationId":"delete_capsule_capsules__capsule_id__delete","parameters":[{"name":"capsule_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Capsule Id"}},{"name":"x-openakashic-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Openakashic-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Capsule Capsules  Capsule Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mentions/search":{"get":{"summary":"Search Mentions","operationId":"search_mentions_mentions_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Mentions Mentions Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/entities":{"post":{"summary":"Create Entity","operationId":"create_entity_entities_post","parameters":[{"name":"x-openakashic-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Openakashic-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Entity Entities Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/entities/search":{"get":{"summary":"Search Entities","operationId":"search_entities_entities_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Entities Entities Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp":{"post":{"summary":"Mcp Endpoint","operationId":"mcp_endpoint_mcp_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mcp Endpoint Mcp Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CapsuleCreate":{"properties":{"title":{"type":"string","minLength":1,"title":"Title"},"summary":{"items":{"type":"string"},"type":"array","title":"Summary"},"key_points":{"items":{"$ref":"#/components/schemas/CapsulePoint"},"type":"array","title":"Key Points"},"cautions":{"items":{"$ref":"#/components/schemas/CapsulePoint"},"type":"array","title":"Cautions"},"source_claim_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Source Claim Ids"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","default":0.5},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["title"],"title":"CapsuleCreate"},"CapsulePoint":{"properties":{"text":{"type":"string","title":"Text"},"claim_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Claim Id"}},"type":"object","required":["text"],"title":"CapsulePoint"},"CapsuleUpdate":{"properties":{"title":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Title"},"summary":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Summary"},"key_points":{"anyOf":[{"items":{"$ref":"#/components/schemas/CapsulePoint"},"type":"array"},{"type":"null"}],"title":"Key Points"},"cautions":{"anyOf":[{"items":{"$ref":"#/components/schemas/CapsulePoint"},"type":"array"},{"type":"null"}],"title":"Cautions"},"source_claim_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Source Claim Ids"},"confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Confidence"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","title":"CapsuleUpdate"},"ClaimCreate":{"properties":{"text":{"type":"string","minLength":1,"title":"Text"},"status":{"type":"string","enum":["pending","accepted","rejected"],"title":"Status","default":"accepted"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","default":0.5},"source_weight":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Source Weight","default":0.5},"claim_role":{"type":"string","enum":["core","support","caution","conflict","example"],"title":"Claim Role","default":"support"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"mentions":{"items":{"$ref":"#/components/schemas/MentionInput"},"type":"array","title":"Mentions"}},"type":"object","required":["text"],"title":"ClaimCreate"},"ClaimStatusUpdate":{"properties":{"status":{"type":"string","enum":["pending","accepted","rejected"],"title":"Status"}},"type":"object","required":["status"],"title":"ClaimStatusUpdate"},"ClaimUpdate":{"properties":{"text":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Text"},"status":{"anyOf":[{"type":"string","enum":["pending","accepted","rejected"]},{"type":"null"}],"title":"Status"},"confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Confidence"},"source_weight":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Source Weight"},"claim_role":{"anyOf":[{"type":"string","enum":["core","support","caution","conflict","example"]},{"type":"null"}],"title":"Claim Role"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","title":"ClaimUpdate"},"EntityCreate":{"properties":{"entity_key":{"type":"string","minLength":1,"title":"Entity Key"},"canonical_name":{"type":"string","minLength":1,"title":"Canonical Name"},"entity_type":{"type":"string","title":"Entity Type","default":"concept"},"status":{"type":"string","title":"Status","default":"active"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["entity_key","canonical_name"],"title":"EntityCreate"},"EvidenceCreate":{"properties":{"claim_id":{"type":"string","format":"uuid","title":"Claim Id"},"source_type":{"type":"string","minLength":1,"title":"Source Type"},"source_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Uri"},"excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt"},"hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hash"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["claim_id","source_type"],"title":"EvidenceCreate"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MentionInput":{"properties":{"mention_text":{"type":"string","title":"Mention Text"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Entity Id"}},"type":"object","required":["mention_text"],"title":"MentionInput"},"QueryFilters":{"properties":{"status":{"items":{"type":"string","enum":["pending","accepted","rejected"]},"type":"array","title":"Status"}},"type":"object","title":"QueryFilters"},"QueryOptions":{"properties":{"expand_mentions":{"type":"boolean","title":"Expand Mentions","default":true},"expand_related_claims":{"type":"boolean","title":"Expand Related Claims","default":true},"include_related_capsules":{"type":"boolean","title":"Include Related Capsules","default":false}},"type":"object","title":"QueryOptions"},"QueryRequest":{"properties":{"query":{"type":"string","minLength":1,"title":"Query"},"top_k":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Top K","default":8},"include_related_capsules":{"type":"boolean","title":"Include Related Capsules","default":false},"include":{"items":{"type":"string","enum":["claims","evidences","evidence","capsules"]},"type":"array","title":"Include"},"mode":{"type":"string","enum":["compact","standard","full"],"title":"Mode","default":"standard"},"fields":{"items":{"type":"string"},"type":"array","title":"Fields"},"filters":{"$ref":"#/components/schemas/QueryFilters"},"options":{"$ref":"#/components/schemas/QueryOptions"}},"type":"object","required":["query"],"title":"QueryRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}