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

# API Reference

> Programmatically manage signals, targets, and destinations with the 1eye REST API.

The 1eye API lets you programmatically manage signals, targets, and destinations. All endpoints are HTTPS, accept and return JSON, and are authenticated with an API key.

## Base URL

```text theme={null}
https://api.1eye.com/v1
```

## Authentication

Pass your API key in the `Authorization` header on every request:

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

Generate keys from your workspace settings. Keep them secret and rotate any key that leaks.

## Response format

Successful responses return a JSON object with the requested resource. Errors return a JSON object with an `error` field and an appropriate HTTP status code.

```json theme={null}
{
  "error": {
    "code": "not_found",
    "message": "Resource not found"
  }
}
```

## Rate limits

Requests are limited per API key. When you exceed the limit, the API returns `429 Too Many Requests`. Retry with exponential backoff.