The AI API behind every SuperCognit agent
One REST API to create agents and MCP servers, attach tools and knowledge, read every conversation and push events into your own systems. OpenAPI 3.1, key authentication, no SDK required.
https://api.supercognit.com/v1Your first call
Anything with an HTTP client works — curl, your backend, a workflow tool, another agent.
curl https://api.supercognit.com/v1/products \
-H "X-Api-Key: $SUPERCOGNIT_API_KEY"Authenticate with a workspace key
Create a key in the dashboard and send it as an X-Api-Key header. Keys carry read or write scope, and a key can be locked to a single product — so an integration only ever touches what you gave it.
What the API covers
What you can do in the dashboard, your code can do too — same workspace, same resources.
Products
/v1/productsCreate, update, publish and unpublish chat agents and MCP servers — prompt, summary, slug and price included.
Tools
/v1/toolsManage the workspace tool library: LLM, HTTP and static tools, their inputs, and which products use them.
Knowledge bases
/v1/knowledge-basesList the knowledge behind your answers and see which products each base is attached to.
Conversations
/v1/sessionsRead conversations and full transcripts — every message, model and token count, ready for your analytics or your CRM.
Webhooks
/v1/webhooksRegister endpoints, inspect deliveries and retries, and re-enable an endpoint without touching the dashboard.
Wallet
/v1/walletRead the usage-credit balance and every top-up, charge and refund behind it.
End users
/v1/verify-userVerify a chat session token server-side, so your own app can trust who it is talking to.
What teams build with it
An agent per customer
Agencies and SaaS teams create, configure and publish one agent per client straight from their own onboarding flow — no clicking through the dashboard.
Conversations in your CRM
Stream every conversation and captured contact into HubSpot, Salesforce or your own database as it happens.
Knowledge that stays current
Refresh a knowledge source when your docs change, so answers follow your product instead of trailing behind it.
Usage you can bill on
Read the wallet and the transcripts to see exactly what an account consumed, then charge for it inside your own product.
Events, pushed to you
Register an endpoint and SuperCognit POSTs JSON as conversations happen. Every request is signed with HMAC-SHA256 over the raw body, retried up to five times with exponential backoff, and kept in a delivery log with its response status.
- conversation.created — someone started a new conversation
- message.created — a message was sent, by a visitor or by the agent
- message.completed — the agent finished its answer
REST for your systems, MCP for AI clients
The API is how your code drives SuperCognit. MCP is how AI clients — Claude, Cursor, your own agents — use what you publish. Both run on the same workspace, so a tool you build once is reachable either way.
See MCP servers →Questions developers ask
Yes. Every plan includes API access at no extra charge — you pay your plan and the usage your agents generate, exactly as you would from the dashboard. The 7-day free trial includes it too.
With a workspace API key, sent as the X-Api-Key header. Keys declare scopes — write is required for anything that is not a GET — and a key can be scoped to a single product, in which case it cannot touch workspace-level resources such as tools, knowledge bases or webhooks.
No. It is plain REST over JSON, so any HTTP client works. The OpenAPI 3.1 document is public, so you can also generate a typed client in the language of your choice in a couple of minutes.
Yes. Create the product, attach tools and knowledge bases, then publish it — the same lifecycle the dashboard uses. That is how teams provision one agent per customer automatically.
The platform runs a curated model behind your agents, so your integration never handles provider keys or model names. You build and ship the agent; we keep the model current underneath it.
Two ways: read the conversation endpoints for sessions and transcripts, or register a webhook and receive each message as it happens. Most teams use webhooks for realtime and the endpoints for backfill.
Build with the API
Create a workspace, generate a key, ship your integration — free for 7 days.