Descripción general de la API

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; guárdalas en tu servidor
Cuerpos	JSON, snake_case; los campos desconocidos dan `400`
Especificación	api.conare.ai/openapi.yaml

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

{
  "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 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
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 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	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)
`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)
`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).

Response

{ "status": "ok", "checkedAt": "2026-10-21T21:39:16.729996745Z" }

Descripción general

Namespaces

Documentos

Búsqueda

Archivos

Análisis

Fuentes

Fuentes personalizadas

Modelos

Usuarios

Eventos

Organizaciones

Estado

Descripción general de la API

Errores

Reintentos

Límites de frecuencia

Cabeceras

Estado

​Errores

​Reintentos

​Límites de frecuencia

​Cabeceras

​Estado

Errores

Reintentos

Límites de frecuencia

Cabeceras

Estado