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

# Kovi REST API — API Key Authentication with Bearer

> Pass your Kovi API key in the Authorization: Bearer header on every REST API request. Get your key from the Techeval dashboard Settings page.

Every Kovi REST API request must include your API key as a Bearer token in the `Authorization` header. You can find and manage your API keys in the [Techeval dashboard](https://techeval.ai).

## Authorization Header Format

Include the following header in every request you make to the API:

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

Replace `YOUR_API_KEY` with the key you copied from the Techeval dashboard.

## Example Request

The following example shows a complete authenticated request to schedule an interview:

```bash theme={null}
curl -X POST https://api.techeval.ai/v1/interviews \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id": "JD-AI-7284", "candidate_name": "Jane Smith", "candidate_email": "jane@example.com", "mobile_number": "+1-5550001234", "role": "AI Engineer", "interview_type": "Technical Deep Dive", "evaluation_level": "Mid-Level to Senior", "tech_stack": ["Python", "FastAPI"], "duration": 30, "pass_score": 6.5, "deadline_hours": 48}'
```

## Getting Your API Key

Follow these steps to retrieve your API key from the Techeval dashboard:

1. Log in to your account at [techeval.ai](https://techeval.ai).
2. Navigate to **Settings** in the left sidebar.
3. Click **API Keys**.
4. Copy your key and store it securely.

If you have not yet signed up, new accounts receive **10 free credits** upon registration.

## Error Responses

If your request is missing a key or uses an invalid one, the API returns one of the following errors:

| HTTP Status | Error | Cause |
| - | - | - |
| `401` | `unauthorized` | Missing or invalid API key |
| `403` | `forbidden` | API key lacks permission for this resource |

**Example 401 response:**

```json theme={null}
{
  "error": "unauthorized",
  "message": "Missing or invalid API key. Include a valid Bearer token in the Authorization header."
}
```

<Warning>
  Never expose your API key in client-side code or public repositories. If your key is compromised, rotate it immediately from the **Settings → API Keys** page in the Techeval dashboard.
</Warning>


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