Ingest your knowledge base, drop one script tag on your site, and every answer is grounded with citations — with human escalation built in. 14-day free trial, no card required.
=> 1. Sign up (14-day trial)
curl -X POST https://yagno-supportgrid.fly.dev/api/auth/signup \
-H "content-type: application/json" \
-d '{"email":"you@company.com","password":"s3cure-pass","companyName":"Acme"}'
=> 2. Create an API key (use the JWT from step 1)
curl -X POST https://yagno-supportgrid.fly.dev/api/keys \
-H "authorization: Bearer $JWT" -H "content-type: application/json" \
-d '{"name":"server key"}'
=> 3. Add an article, then chat
curl -X POST https://yagno-supportgrid.fly.dev/v1/articles \
-H "authorization: Bearer sk_sg_..." -H "content-type: application/json" \
-d '{"title":"Refund policy","body":"Refunds are issued to your original payment method within 30 days of purchase. Contact support with your order number.","tags":["billing","refunds"]}'
curl -X POST https://yagno-supportgrid.fly.dev/v1/chat \
-H "authorization: Bearer sk_sg_..." -H "content-type: application/json" \
-d '{"message":"How do refunds work?"}'
Create a publishable key (pk_sg_...) and embed:
<script src="https://yagno-supportgrid.fly.dev/widget.js" data-key="pk_sg_..." async></script>
Publishable keys can only call POST /v1/chat — safe to ship in public HTML. Try it live at /demo?key=pk_sg_....
| Endpoint | Auth | Description |
|---|---|---|
POST/api/auth/signup · /login | — | Create account / sign in → JWT |
GET/api/auth/me | JWT | Current account |
POSTGETDEL/api/keys | JWT | Manage secret (sk_sg_) and publishable (pk_sg_) keys |
GET/api/usage | JWT | Current-period usage vs plan limits |
POST/api/billing/checkout · /portal | JWT | Subscribe / manage billing |
POSTGETPUTDEL/v1/articles + /v1/articles/import | API key | Knowledge-base CRUD + bulk import |
POST/v1/chat | API key or widget key | Grounded answer with citations + escalation flag |
GET/v1/conversations · /:sessionId | API key | Conversation history |
GETPUT/v1/escalation-config | API key | Webhook, email, trigger keywords |
GET/widget.js · /demo | — | Embeddable widget + live demo page |
Every account starts with a 14-day free trial (Starter limits). No card required.