Connect KI.ordo to your programs.
Call agents and flows through a simple REST API or start flows by webhook.
curl -X POST https://app.www.kiordo.de/api/v1/agents/AGENT_ID/run \
-H "Authorization: Bearer ordo_…" \
-d '{"message":"How does a project work?"}'{ "answer": "In four steps …",
"citations": [ … ] }What is included.
API keys
Per workspace, with name, prefix and last use. Revocable at any time.
Call an agent
POST /api/v1/agents/{id}/run – answer with sources and token counts.
Run a flow
POST /api/v1/flows/{id}/run – result and run ID.
Webhooks
A secret address per flow, without a key – handy for forms and other tools.
Your first call in three steps.
- 1
Create a key
Create an API key in the settings and keep it safe.
- 2
Copy an example
Ready-made calls with the right ID are listed in the settings, right below the keys.
- 3
Make the call
Send a POST request with the key in the header. That’s it.
Questions about the API.
Are there limits?
Yes. Requests per address are limited, and a monthly token limit protects against unexpected costs.
What is the difference between the API and a webhook?
The API needs a key and can call agents and flows. A webhook is a secret address for exactly one flow, handy for forms and automation services.
What happens if a key gets lost?
Revoke it in the settings and create a new one. The old key stops working immediately.