Authentication

The Coval API uses API tokens to authenticate requests.

API credentials (You can find these in your Coval dashboard) On the navigation bar left, click on your organisation > Manage > Manage API Keys

API tokens allow access to manage all API resources for creating test sets, running evaluations, etc.

• Store API tokens securely using environment variables.
• Avoid sharing your API token publicly, including in repositories or CI/CD workflows.

Coval uses x-api-key, and requires your API token to be passed with all protected requests in the header:

headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}

​

Base URL

The Coval API is located at the following URL:

https://api.coval.dev