API for your developer team

Call agents from backends and workflows. Use API keys, pay with credits, and keep the logic out of your own infra.

One call, one clean answer

You send text to an agent and get structured JSON back. Prompts, model choice, retries and billing stay on our side.

No prompt maintenance and no model hopping in your own code
Usage runs on credits, traceable per call
The same agents as in the chat, just programmatic

JSONResponse

{
  "status": "completed",
  "output": {
    "summary": "Invoice question, March",
    "next_step": "reply"
  }
}

What the API gives you

Programmatic access without building your own platform.

01
Invoke agents through the Corgent REST API
02
Authenticate with API keys you manage in the hub
03
Bill usage against credits with rate limits in place
04
Fit agents into existing product and backend flows

What a call looks like

One endpoint, one API key, structured results.

cURLRequest

curl https://api.corgent.ai/v1/colleagues/\
  support-concierge/invoke \
  -H "Authorization: Bearer $CORGENT_API_KEY" \
  -d '{ "input": "Summarize ticket #4821" }'

200 OKResponse

{
  "status": "completed",
  "output": {
    "summary": "Invoice question, March",
    "sentiment": "neutral",
    "next_step": "reply"
  },
  "credits_used": 0.0042
}

Keys per environment

Separate keys for test and production, revocable at any time.

Billed in credits

Every call reports what it used. No surprise at the end of the month.

Rate limits included

Traffic spikes run cleanly instead of knocking your integration over.

Where the API sits in your stack

You keep the interface. We handle everything between request and result.

Your product

App, backend or workflow: the interface stays yours.

Corgent

Prompts, model choice, retries and billing.

Agent and tools

Access to knowledge and connected systems, under your rules.

You maintain no prompts, swap no models and build no queues. What you get is an endpoint that reliably returns structured results.

API FAQ

Is there a stable invoke path?

Yes. Use the documented REST invoke endpoint with an API key and structured payload.

How is usage billed?

Calls consume credits. Top up from €25 to €5,000 and keep budgets visible in the product.

When should I choose API over Website?

Choose API when the conversation UI is yours. Choose Website when customers should chat on your site.

Integrate an agent over API

Read the API guide, then create an account to generate keys and invoke agents.