# API Reference

Complete reference for the Context Link API.

## Base URL

```
https://context-link.ai/api/v1
```

## Authentication

All requests require an API key in the `Authorization` header:

```bash
Authorization: your-api-key-here
```

Get your API key from [Settings](https://context-link.ai/user/settings).

## Endpoints


### Context

Query your connected knowledge sources.

```
GET /api/v1/context?query=your-topic&mode=optional-mode
```

[View full documentation →](/docs/context-endpoint)

### Save

Save content to Context Link's memory for later retrieval.

```
POST /api/v1/context/save?namespace=your-namespace
```

[View full documentation →](/docs/save-endpoint)

## Common responses

### Success response (query)

```json
{
    "message": "Response content",
    "format": "markdown"
}
```

### Success response (save)

```json
{
    "message": "Saved",
    "namespace": "your-namespace"
}
```

### Error response

```json
{
    "message": "Error description"
}
```

## Status codes

| Code | Description |
|------|-------------|
| `200` | Request successful |
| `201` | Content saved successfully |
| `400` | Bad request - missing required parameters |
| `401` | Unauthorized - invalid or missing API key |
| `404` | Not found - invalid API key or resource |
| `422` | Unprocessable entity - empty request body |
| `429` | Too many requests - rate limit exceeded |