Skip to main content
The Cognigy.AI 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.AI 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 OAuth2 authentication to get an access token via the standard OAuth2 Client Credentials flow. Provide the access token in the Authorization header as a Bearer token.
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.AI API: https://api-trial.cognigy.ai/new/