


API-first platform — everything is accessible via endpoints and webhooks.
Base URL
https://api.orenyxaiengine.com/v1[PLACEHOLDER — confirm the API domain before publishing]
API key–based authentication via an Authorization header.
Authorization: Bearer <API_KEY>| Endpoint | Method | Purpose |
|---|---|---|
| /dispatch/events | POST | Submit a dispatch event for routing |
| /bots/execute | POST | Trigger a bot flow execution |
| /payments/decision | POST | Request a payment risk/routing decision |
| /context/state | GET/POST | Read or update shared context/state |
| /webhooks/subscribeNew | POST | Register a webhook endpoint |
| /auth/keysNew | GET/POST | Manage API keys |
Starter
10 requests/second
burst to 30
Growth
50 requests/second
burst to 150
Enterprise
Custom limits
—
Rate limit headers are returned on every response:
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset| Code | Meaning |
|---|---|
| 400 | Malformed request / validation error |
| 401 | Invalid or missing API key |
| 403 | Valid key, insufficient permissions |
| 404 | Resource not found |
| 429 | Rate limit exceeded |
| 500 | Internal engine error |
| 503 | Service temporarily unavailable |
Event types:
dispatch.completedbot.execution.completedpayment.decision.completedcontext.updatedURL-based versioning (/v1/, /v2/).
Deprecated versions are supported for a minimum of 12 months after a new version ships, with advance notice via the Changelog and email.
Changelog →Until SDKs ship, all functionality is available via plain REST calls — examples are provided in cURL, Node, and Python in the docs.
Every account includes a sandbox environment with test API keys.