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 three authentication methods:
  • API Key. Use an API Key in the request path or HTTP headers. Keep it secure and never share it. If it gets exposed, revoke it immediately.
  • BasicAuth. Use 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/