{"openapi":"3.1.0","info":{"title":"Chateleon AI Agent API","version":"2.0.0","description":"User-engaging mascot and avatar integration for websites with verified A2A agent support, reporting dashboards, and instant preview. Acts as the official Support Agent, Booking Agent, Demo Agent, Human Handoff Desk, and Team Reachout handler for Chateleon.","contact":{"name":"Chateleon AI Agent & Support Team","url":"https://chateleon.com"}},"servers":[{"url":"https://agent-raja-api.test-vengatesh.workers.dev/v1/a/chateleon-com","description":"Hosted Multi-Protocol Agent Gateway"}],"paths":{"/a2a":{"get":{"operationId":"getA2AStatus","summary":"A2A Endpoint Health, Capabilities & Quick Query","description":"Inspect A2A endpoint capabilities or ask a question with ?q=","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Optional test query"}],"responses":{"200":{"description":"A2A status or query answer","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"service":{"type":"string"},"protocol":{"type":"string"},"answer":{"type":"string"}},"additionalProperties":true}}}}}},"post":{"operationId":"executeA2A","summary":"Google A2A JSON-RPC 2.0 Protocol Endpoint","description":"Executes A2A JSON-RPC 2.0 methods including SendMessage, support-agent, booking-agent, demo-agent, human-handoff, team-reachout, lead-inquiry, business-profile, operating-hours, offerings, coverage, GetTask, and ListTasks.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method","id"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"method":{"type":"string","example":"SendMessage","description":"A2A method: SendMessage, support-agent, booking-agent, demo-agent, human-handoff, team-reachout, lead-inquiry, coverage, GetTask, ListTasks"},"params":{"type":"object","additionalProperties":true},"id":{"type":["string","number"],"example":1}}}}}},"responses":{"200":{"description":"JSON-RPC 2.0 result envelope with autonomous answer, booking/support reference ID, or task status.","content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"type":["string","number"]},"result":{"type":"object","additionalProperties":true},"error":{"type":"object","additionalProperties":true}},"required":["jsonrpc"]}}}}}}},"/ask":{"get":{"operationId":"askQuestionGet","summary":"Ask a question via GET","description":"Ask the support/sales/booking agent a question using query parameter ?q=","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Question for the business agent"}],"responses":{"200":{"description":"Answer from agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"query":{"type":"string"},"answer":{"type":"string"},"model":{"type":"string"}},"required":["ok","answer"]}}}}}},"post":{"operationId":"askQuestionPost","summary":"Natural Language Question Answering via POST","description":"Submits a question using JSON body { message: \"...\" } to the verified agent knowledge base.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","example":"What services do you provide?"}}}}}},"responses":{"200":{"description":"Grounded response generated from verified FactSheet.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"query":{"type":"string"},"answer":{"type":"string"},"model":{"type":"string"}},"required":["ok","answer"]}}}}}}},"/agent.json":{"get":{"operationId":"getProfile","summary":"Get Verified Business Profile","description":"Source-linked factsheet data including roles, hours, products, services, contact, and evidence.","responses":{"200":{"description":"Full profile","content":{"application/json":{"schema":{"type":"object","properties":{"schemaVersion":{"type":"string"},"slug":{"type":"string"},"domain":{"type":"string"}},"additionalProperties":true}}}}}}},"/leads":{"get":{"operationId":"submitLeadGet","summary":"Submit Support Ticket, Booking, Demo, Human Handoff, or Team Reachout via GET","description":"Submits support tickets, demo bookings, appointment schedules, human handoffs, or team reachouts using query parameters for GET-only web browsing assistants.","parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Visitor or contact name"},{"name":"email","in":"query","required":true,"schema":{"type":"string"},"description":"Contact email address"},{"name":"message","in":"query","required":false,"schema":{"type":"string"},"description":"Support issue, booking preference, demo details, or reachout message"},{"name":"phone","in":"query","required":false,"schema":{"type":"string"},"description":"Optional contact phone number"},{"name":"service","in":"query","required":false,"schema":{"type":"string","enum":["support","booking","demo","human-handoff","team-reachout","quote"]},"description":"Action role category (support, booking, demo, human-handoff, team-reachout, quote)"},{"name":"location","in":"query","required":false,"schema":{"type":"string"},"description":"Customer location or timezone"},{"name":"consent","in":"query","required":true,"schema":{"type":"boolean"},"description":"Explicit contact consent (true)"}],"responses":{"201":{"description":"Request registered and team notified.","content":{"application/json":{"schema":{"type":"object","properties":{"accepted":{"type":"boolean"},"referenceId":{"type":"string"},"message":{"type":"string"}},"required":["accepted","referenceId"]}}}}}},"post":{"operationId":"submitLead","summary":"Submit Support Ticket, Booking, Demo, Human Handoff, or Team Reachout (POST)","description":"Submits any customer support, booking, demo, human handoff, or team reachout inquiry directly to the business team.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","email","message","consent"],"properties":{"name":{"type":"string","example":"Alex Smith"},"email":{"type":"string","format":"email","example":"alex@example.com"},"phone":{"type":"string"},"message":{"type":"string","example":"I would like to book a live product demo."},"service":{"type":"string","example":"demo","description":"Category: support, booking, demo, human-handoff, team-reachout, or specific offering"},"location":{"type":"string"},"preferredTime":{"type":"string","description":"Optional preferred date/time for booking or demo"},"consent":{"type":"boolean","enum":[true]}}}}}},"responses":{"201":{"description":"Request accepted and stored in the business team inbox.","content":{"application/json":{"schema":{"type":"object","properties":{"accepted":{"type":"boolean"},"referenceId":{"type":"string"},"message":{"type":"string"}},"required":["accepted","referenceId"]}}}}}}}},"components":{"schemas":{}}}