> ## Documentation Index
> Fetch the complete documentation index at: https://docs-classic.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# About Cognigy API

> Introduction to the Cognigy REST API, covering authentication, CORS support, and RESTful endpoints for managing AI Agents and platform resources.

The Cognigy API follows a [RESTful](https://en.wikipedia.org/wiki/REST) 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](https://fetch.spec.whatwg.org/). All responses include a wildcard `Access-Control-Allow-Origin` header, enabling cross-domain browser requests.

### Authentication

Cognigy supports the following authentication methods:

> [accordion] API Key
>
> For Cognigy installations, use an [API key](https://docs-classic.cognigy.com/ai/administer/user-menu/my-profile.md#api-keys) in the request path or HTTP headers. Keep it secure and revoke it if exposed.

> [accordion] BasicAuth
>
> Use a username and password for API requests related to the [Management UI](https://docs-classic.cognigy.com/api-reference/management-ui/create-an-api-key.md).

### Error Handling

The API uses standard HTTP status codes (400 and higher) to indicate errors. Error responses follow [RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807) and include a traceId that you can provide to [Cognigy technical support](https://docs-classic.cognigy.com/help/get-help.md) 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](https://docs-classic.cognigy.com/ai/for-developers/developers/api-and-cli.md#api-base-url).

### API Scope

The Cognigy API is split into independently versioned services:

| API | Base Path | Purpose |
| - | - | - |
| Core Resources | `/new/` | Manages the lifecycle of AI Agents, including Flows, Endpoints, Snapshots, Knowledge Stores, and platform administration. |
| Simulator | `/testing/` | Manages automated testing resources such as scenarios, simulation runs, schedules, and evaluation results. |
| Logs | `/logs/` | Retrieves Flow execution logs and debug entries. |

All services share the same authentication methods and error-handling conventions described above.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.