Skip to main content
The Cognigy API follows a RESTful design and uses standard HTTP methods, status codes, and authentication mechanisms. All endpoints support JSON-encoded responses and predictable resource-oriented URLs.

​
Cross-Origin Resource Sharing (CORS)

The API fully supports CORS in accordance with the W3C specification. All responses include a wildcard Access-Control-Allow-Origin header, enabling cross-domain browser requests.

​
Authentication

Cognigy supports the following authentication methods:
For Cognigy installations, use an API key in the request path or HTTP headers. Keep it secure and revoke it if exposed.
Use a username and password for API requests related to the Management UI.

​
Error Handling

The API uses standard HTTP status codes (400 and higher) to indicate errors. Error responses follow RFC 7807 and include a traceId that you can provide to Cognigy technical support for troubleshooting.

​
API Server

Cognigy API:
  • Core Resources: https://api-trial.cognigy.ai/new/
  • Simulator: https://api-trial.cognigy.ai/testing/
  • Logs: https://api-trial.cognigy.ai/logs/
For constructing the API base URL for your environment, refer to API Base URL.

​
API Scope

The Cognigy API is split into independently versioned services: All services share the same authentication methods and error-handling conventions described above.
Last modified on September 3, 2026