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

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# Descripción general de la API

> URL base, autenticación, errores, reintentos, límites de frecuencia y cabeceras de la API de Conare.

La API de Conare es JSON sobre HTTPS. Cada endpoint tiene una página en esta pestaña, con un playground.

| | |
| - | - |
| URL base | `https://api.conare.ai` |
| Autenticación | `Authorization: Bearer $CONARE_API_KEY` |
| Claves | Se crean en la [consola](https://docs.conare.ai/es/console.md#claves); guárdalas en tu servidor |
| Cuerpos | JSON, snake\_case; los campos desconocidos dan `400` |
| Especificación | [api.conare.ai/openapi.yaml](https://api.conare.ai/openapi.yaml) |

```bash theme={null}
curl https://api.conare.ai/namespaces \
  -H "Authorization: Bearer $CONARE_API_KEY"
```

Las rutas compatibles con OpenAI y Cohere (`/v1`, `/v2`) ignoran los campos desconocidos.

## Errores

```json theme={null}
{
  "error": {
    "code": "invalid_request",
    "message": "documents[0].text is required",
    "request_id": "45ea7c7353368cb646e5cc2303008072"
  }
}
```

| Estado | Significado |
| - | - |
| 400 | La solicitud no es válida; `message` indica por qué |
| 401 | La clave falta, es incorrecta o está revocada |
| 403 | La clave no tiene acceso a este namespace o ruta |
| 404 | No encontrado |
| 409 | Un conflicto de versión, o ganó una escritura concurrente |
| 413 | El cuerpo, un documento o un archivo es demasiado grande |
| 415 | El tipo de [archivo](https://docs.conare.ai/es/files.md) no es compatible |
| 422 | El archivo no se puede leer, o se reutilizó una `Idempotency-Key` para otra solicitud |
| 429 | Se superó un [límite de frecuencia](#límites-de-frecuencia) |
| 5xx | Un problema por nuestra parte |

## Reintentos

| Caso | Qué hacer |
| - | - |
| `429`, `503` | Reintenta tras los segundos que indica la cabecera `Retry-After` |
| Otros 5xx | Reintenta con backoff |
| Escrituras y eliminaciones | Envía una `Idempotency-Key` (un UUID); una repetición en 24 horas devuelve la primera respuesta con `Idempotent-Replayed: true` y no cambia nada |

El [SDK](https://docs.conare.ai/es/sdk.md) reintenta y envía la `Idempotency-Key` por ti.

## Límites de frecuencia

Por organización. Se admiten ráfagas equivalentes a hasta 10 segundos; si se supera un límite, la API devuelve `429` con `Retry-After`.

| Llamadas | Por segundo | En curso a la vez |
| - | - | - |
| Búsqueda | 100 | 128 |
| Escritura | 100 documentos | 64 |
| Embedding | 100 textos | 16 |
| Rerank | 20 | 16 |
| Consultas de la [API de turbopuffer](https://docs.conare.ai/es/turbopuffer.md) | 1.000 | |
| Todo lo demás | 100 | |

## Cabeceras

| Cabecera | Dirección | Significado |
| - | - | - |
| `Authorization` | Solicitud | `Bearer` y tu clave |
| `Idempotency-Key` | Solicitud | Permite reintentar una escritura de forma segura |
| `X-Conare-Org` | Solicitud | La organización en cuyo nombre actuar, con una clave multiorganización ([lístalas](https://docs.conare.ai/es/api-reference/organizations/list-organizations.md)) |
| `Content-Encoding: gzip` | Solicitud | Un cuerpo comprimido; los límites lo cuentan descomprimido |
| `X-Request-Id` | Respuesta | En cada respuesta; inclúyelo cuando contactes con soporte |
| `Retry-After` | Respuesta | Segundos que esperar, en `429` y `503` |
| `Conare-Degraded` | Respuesta | La solicitud tuvo éxito sin parte de su trabajo, como el reranking ([valores](https://docs.conare.ai/es/query.md#resultados-degradados)) |
| `Idempotent-Replayed` | Respuesta | `true` cuando un reintento obtuvo la primera respuesta |

## Estado

`GET /health/deep` no necesita clave: `status` es `ok`, `degraded` (ambos HTTP 200) o `down` (HTTP 503).

```json Response theme={null}
{ "status": "ok", "checkedAt": "2026-10-21T21:39:16.729996745Z" }
```


## Related topics

- [API de turbopuffer](https://docs.conare.ai/es/turbopuffer.md)
- [SDK de TypeScript](https://docs.conare.ai/es/sdk.md)
- [Tipos de archivo y Markdown](https://docs.conare.ai/es/file-types.md)
- [Introducción](https://docs.conare.ai/es/index.md)
- [Fuentes](https://docs.conare.ai/es/sources.md)


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