{"openapi":"3.1.0","info":{"title":"Grail AI Discovery API","version":"1.0.0","description":"Grail helps 50+ employee companies run AI transformation programs, identify the best internal workflows to automate, and deploy approval-controlled AI employees across their existing systems."},"servers":[{"url":"https://grail.computer"}],"paths":{"/api/nlweb/search":{"get":{"operationId":"searchGrailSite","summary":"Search public Grail pages for AI agents and search crawlers.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Search query."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25,"default":10},"description":"Maximum number of results."}],"responses":{"200":{"description":"Search results.","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveryResult"}}}}}}}}}},"/api/nlweb/ask":{"get":{"operationId":"answerGrailSiteQuestion","summary":"Return a concise answer with relevant public Grail sources.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Question or search query."}],"responses":{"200":{"description":"Answer and sources.","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"answer":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/DiscoveryResult"}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"}}}}}}}}}}}}},"components":{"schemas":{"DiscoveryResult":{"type":"object","properties":{"path":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"score":{"type":"number"}},"required":["path","url","title","description","category"]}}}}