{"openapi":"3.1.0","info":{"title":"GraphReel Public API","description":"Authenticated public REST surface (/v1) and discovery metadata. Admin and internal routes are not included.","version":"0.1.0"},"servers":[{"url":"https://api.graphreel.com","description":"GraphReel API"}],"paths":{"/v1/resolve":{"get":{"tags":["public"],"summary":"Resolve","operationId":"resolve_v1_resolve_get","parameters":[{"name":"scheme","in":"query","required":true,"schema":{"type":"string","title":"Scheme"}},{"name":"value","in":"query","required":true,"schema":{"type":"string","title":"Value"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/disambiguate":{"get":{"tags":["public"],"summary":"Disambiguate","operationId":"disambiguate_v1_disambiguate_get","parameters":[{"name":"title","in":"query","required":true,"schema":{"type":"string","title":"Title"}},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"default":10,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/relationships":{"get":{"tags":["public"],"summary":"Relationships","operationId":"relationships_v1_relationships_get","parameters":[{"name":"gr_id","in":"query","required":true,"schema":{"type":"string","title":"Gr Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/provenance":{"get":{"tags":["public"],"summary":"Provenance","operationId":"provenance_v1_provenance_get","parameters":[{"name":"gr_id","in":"query","required":true,"schema":{"type":"string","title":"Gr Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"bearerAuth":[]}]}},"/.well-known/agent-card.json":{"get":{"tags":["discovery"],"summary":"Agent Card","description":"A2A Agent Card describing GraphReel's capabilities.","operationId":"agent_card__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/mcp.json":{"get":{"tags":["discovery"],"summary":"Mcp Pointer","description":"Pointer to the MCP endpoint and its tool names.","operationId":"mcp_pointer__well_known_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"tags":["discovery"],"summary":"Llms Txt","description":"Agent-oriented site summary (llms.txt convention).","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/robots.txt":{"get":{"tags":["discovery"],"summary":"Robots Txt","description":"Crawler policy: public + /v1 allowed; admin and internal blocked.","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key minted via scripts/mint_api_key.py"}}},"security":[{"bearerAuth":[]}]}