{"openapi":"3.1.0","info":{"title":"Agent FAI Workload API","version":"1.0.0","description":"Embed the grounded FAI Engine in applications, automations, and Studio workloads.","contact":{"name":"FrootAI","url":"https://frootai.dev"}},"servers":[{"url":"https://frootai.dev/v1/agent","description":"FrootAI production gateway"}],"paths":{"/chat":{"post":{"operationId":"runAgentFai","summary":"Run Agent FAI","security":[{"FaiApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","maxLength":8000},"threadId":{"type":"string","format":"uuid","nullable":true,"description":"Optional durable conversation identifier shared across Agent FAI surfaces."},"mode":{"type":"string","enum":["auto","answer","architecture","plan","review"],"default":"auto"},"capabilities":{"type":"object","properties":{"diagrams":{"type":"boolean","default":true},"citations":{"type":"boolean","default":true}}},"history":{"type":"array","maxItems":10,"items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["user","assistant"]},"content":{"type":"string"}}}}}}}}},"responses":{"200":{"description":"Grounded Agent FAI response with request correlation, usage, MCP activity, citations, and product-registry freshness metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentFaiResponse"}}}},"401":{"description":"Missing, invalid, or revoked fai_live_ API key"},"429":{"description":"Account API quota exceeded"},"502":{"description":"FAI Engine unavailable"}}}}},"components":{"schemas":{"ProductRegistryMetadata":{"type":"object","required":["schemaVersion","updatedAt","digest","products"],"properties":{"schemaVersion":{"type":"string","example":"1.0.0"},"updatedAt":{"type":"string","format":"date","example":"2026-07-29"},"digest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"products":{"type":"integer","minimum":1,"example":12}}},"AgentFaiResponse":{"type":"object","required":["reply","agent"],"properties":{"reply":{"type":"string"},"usage":{"type":"object","additionalProperties":true},"agent":{"type":"object","required":["requestId","version","grounding"],"properties":{"requestId":{"type":"string"},"version":{"type":"string"},"threadId":{"type":["string","null"],"format":"uuid"},"grounding":{"type":"object","properties":{"corpusSize":{"type":"integer","example":1017},"productRegistry":{"$ref":"#/components/schemas/ProductRegistryMetadata"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}}},"securitySchemes":{"FaiApiKey":{"type":"http","scheme":"bearer","bearerFormat":"fai_live_...","description":"Revocable personal API key created from your signed-in FrootAI account."}}}}