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

# API de conocimiento

> API de conocimiento — Visito M2M API

Las rutas son relativas a `/m2m/v1`. Envía `Authorization: Bearer <clave>`. La clave determina el tenant.

Usa `knowledge:read` para lectura y `knowledge:write` para administrar. Se mantienen los límites, cuotas y formatos existentes.

| Método | Ruta                                   | Uso                                                         |
| ------ | -------------------------------------- | ----------------------------------------------------------- |
| GET    | `/knowledge/sources`                   | Lista con limit (1–200), cursor, status, sourceType y query |
| GET    | `/knowledge/sources/{sourceId}`        | Detalle; includeInactive opcional                           |
| GET    | `/knowledge/usage`                     | Consumo y cuota disponible                                  |
| POST   | `/knowledge/text`                      | Crear o reemplazar texto por sourceId                       |
| POST   | `/knowledge/file`                      | Multipart con campo file, máximo 10 MiB                     |
| POST   | `/knowledge/url`                       | Ingerir una URL                                             |
| POST   | `/knowledge/url/crawl`                 | Iniciar rastreo; devuelve 202 y jobId                       |
| GET    | `/knowledge/url/crawl/{jobId}`         | Progreso y resultado                                        |
| PATCH  | `/knowledge/sources/{sourceId}/active` | Activar/desactivar con active booleano                      |
| DELETE | `/knowledge/sources/{sourceId}`        | Eliminar; devuelve 204                                      |

```json theme={null}
{"text":"El check-in empieza a las 3 pm.","title":"Política de check-in","sourceId":"check-in"}
```

Límites: texto 200,000 caracteres, título 160, sourceId 128. No puedes reemplazar con texto una fuente de otro tipo. La creación devuelve 201 y la actualización 200. Una nueva fuente puede guardarse inactiva por cuota; revisa `active` y `quotaExceeded`. Actualizar una fuente activa excediendo cuota devuelve 409.

El modelo actual usa fuentes y no requiere `knowledgeBaseId`. Los archivos aceptan `title` y `assetUpload` opcionales, pero no `sourceId`. El rastreo acepta `url`, `crawlDepth` (1–3; predeterminado 2) y `maxPages` (1–500; predeterminado 500).