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

# Overview

> Legacy API version

<Warning>
  **API v1 (legacy) is not recommended for use.** New integrations should use API v2. V1 will continue to work but won't receive new features.
</Warning>

API v1 provides read-only access to your Promptwatch monitoring data. For full CRUD operations and new features, migrate to v2.

## What's Included

* **Authentication** - Validate API keys
* **Models** - List available LLM models
* **Monitors** - List monitors (read-only)
* **Prompts** - List and get prompts (read-only)
* **Visibility** - Track visibility metrics over time
* **Citations** - Analyze citation sources and domains
* **Analytics** - Visitor and crawler analytics
* **Share of Voice** - Brand mention analytics
* **Responses** - Response analytics with sentiment
* **Brands** - Brand visibility analytics

## Base URL

```
https://server.promptwatch.com/api/v1
```

## Authentication

Include your API key in the `X-API-Key` header:

```bash theme={null}
curl -X GET "https://server.promptwatch.com/api/v1/models" \
  -H "X-API-Key: your-api-key"
```

For organization-level keys accessing a specific project:

```bash theme={null}
curl -X GET "https://server.promptwatch.com/api/v1/monitors" \
  -H "X-API-Key: your-org-api-key" \
  -H "X-Project-Id: your-project-uuid"
```

## Migrating to v2

Migration is straightforward:

1. Update base URL from `/api/v1` to `/api/v2`
2. Authentication headers remain the same
3. Most endpoints have the same structure
4. v2 adds CRUD operations for monitors, prompts, tags, and projects

## Support

* **Email**: [team@promptwatch.com](mailto:team@promptwatch.com)
* **Website**: [promptwatch.com](https://promptwatch.com)