> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.gradii.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.gradii.ai/_mcp/server.

# Quickstart

> Make your first Gradii API request.

## 1. Get an API token

Generate a Gradii API token from your company admin panel. Tokens should only be shared with trusted backend services.

## 2. List interviews

```bash
curl --request GET \
  --url https://gradii.ai/api/v2/interviews/list \
  --header 'Authorization: Bearer iai_your_token_here'
```

## 3. Schedule an interview

```bash
curl --request POST \
  --url https://gradii.ai/api/v2/interviews/schedule \
  --header 'Authorization: Bearer iai_your_token_here' \
  --header 'Content-Type: application/json' \
  --data '{
    "campaignId": "123e4567-e89b-12d3-a456-426614174000",
    "candidateName": "John Doe",
    "candidateEmail": "john@example.com",
    "interviewDate": "2026-05-12",
    "interviewTime": "10:00",
    "roundNumber": 1,
    "timezone": "Asia/Kolkata"
  }'
```

## 4. Validate Fern configuration locally

```bash
fern check
fern docs dev
```