{"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"},"401":{"description":"Missing, invalid, or revoked fai_live_ API key"},"429":{"description":"Account API quota exceeded"},"502":{"description":"FAI Engine unavailable"}}}}},"components":{"securitySchemes":{"FaiApiKey":{"type":"http","scheme":"bearer","bearerFormat":"fai_live_...","description":"Revocable personal API key created from your signed-in FrootAI account."}}}}