Bot · Conocimiento (RAG)

Referencia de 13 endpoints generados desde mosend-wb-backend/src/modules/bot/knowledge/knowledge.controller.ts.

Base path: /organizations/:orgId/bot/knowledge·13 endpoints·Source: mosend-wb-backend/src/modules/bot/knowledge/knowledge.controller.ts

GET/organizations/:orgId/bot/knowledge

bearer

Lista los documentos del knowledge base del bot.

Path params

orgIdstringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/bot/knowledge/search

bearer

Búsqueda semántica (RAG) sobre el knowledge base: embedding del query + similitud coseno sobre los chunks. Mismo retrieval que usa el bot IA.

Path params

orgIdstringrequerido

Body (JSON)

querystringrequerido
topKnumber
Cuántos chunks devolver (1-20, default 5).
tagsstring[]
Filtrar a docs que tengan alguno de estos tags.
minSimilaritynumber
Umbral de similitud coseno 0-1 (default 0.3).
agentIdstring · uuid
Buscar como este agente: solo su memoria (sus documentos + compartidos).

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/search' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"query": "<query>","topK": 0,"tags": [],"minSimilarity": 0,"agentId": "00000000-0000-0000-0000-000000000000"}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

GET/organizations/:orgId/bot/knowledge/insights

bearer

Qué buscó el bot en la memoria en los últimos N días: consultas, tasa de respuesta, preguntas sin respuesta agrupadas, uso por agente y por documento.

Path params

orgIdstringrequerido

Query params

diasstringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/insights' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/bot/knowledge/notes

bearer

Crea una nota (texto escrito en el panel) que el bot usa como conocimiento; se procesa como un documento.

Path params

orgIdstringrequerido

Body (JSON)

titlestring
contentstring
tagsstring[]
resolvesQuestionKeystring
Clave de la pregunta sin respuesta que esta nota cubre (viene de insights).
agentIdsstring[]
compartidoboolean

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/notes' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "<title>","content": "<content>","tags": [],"resolvesQuestionKey": "<resolvesQuestionKey>","agentIds": [],"compartido": true}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/bot/knowledge/url

bearer

Importa una página web pública como fuente de conocimiento; con syncEveryHours se vuelve a leer periódicamente.

Path params

orgIdstringrequerido

Body (JSON)

urlstringrequerido
titlestring
tagsstring[]
syncEveryHoursnumber
Cada cuántas horas volver a leer la página; sin valor = solo a mano.
agentIdsstring[]
compartidoboolean

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/url' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://tu-app.com/endpoint","title": "<title>","tags": [],"syncEveryHours": 0,"agentIds": [],"compartido": true}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

PATCH/organizations/:orgId/bot/knowledge/notes/:id

bearer

Edita una nota; si cambia el texto se vuelve a procesar.

Path params

orgIdstringrequerido
idstringrequerido

Body (JSON)

titlestring
contentstring
tagsstring[]
resolvesQuestionKeystring
Clave de la pregunta sin respuesta que esta nota cubre (viene de insights).
agentIdsstring[]
compartidoboolean

Respuestas

curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/notes/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "<title>","content": "<content>","tags": [],"resolvesQuestionKey": "<resolvesQuestionKey>","agentIds": [],"compartido": true}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

GET/organizations/:orgId/bot/knowledge/:id

bearer

Obtiene el detalle de un documento del knowledge base.

Path params

orgIdstringrequerido
idstringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/bot/knowledge

bearer

Sube un documento. Multipart: file + opcional title, tags (coma).

Path params

orgIdstringrequerido

Body (JSON)

titlestring
tagsstring
Lista de tags separados por coma (viene como string en multipart).
agentIdsstring
Multipart: ids de agentes separados por coma.
compartidostring
Multipart: 'true' para que lo lean todos los agentes.

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "<title>","tags": "<tags>","agentIds": "<agentIds>","compartido": "<compartido>"}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

PATCH/organizations/:orgId/bot/knowledge/:id/title

bearer

Renombra un documento del knowledge base.

Path params

orgIdstringrequerido
idstringrequerido

Body (JSON)

titlestringrequerido

Respuestas

curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/00000000-0000-0000-0000-000000000000/title' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "<title>"}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

PATCH/organizations/:orgId/bot/knowledge/:id/tags

bearer

Re-etiqueta un documento (afecta qué bots lo usan).

Path params

orgIdstringrequerido
idstringrequerido

Body (JSON)

tagsstring[]requerido

Respuestas

curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/00000000-0000-0000-0000-000000000000/tags' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"tags": []}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "cliente-vip",
    "color": "#16a34a"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

PATCH/organizations/:orgId/bot/knowledge/:id/agentes

bearer

Qué agentes leen el documento, o si lo leen todos (compartido). Cada agente lee solo sus documentos y los compartidos.

Path params

orgIdstringrequerido
idstringrequerido

Body (JSON)

agentIdsstring[]requerido
compartidobooleanrequerido

Respuestas

curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/00000000-0000-0000-0000-000000000000/agentes' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"agentIds": [],"compartido": true}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/bot/knowledge/:id/reprocess

bearer

Re-extrae texto + regenera embeddings.

Path params

orgIdstringrequerido
idstringrequerido

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/00000000-0000-0000-0000-000000000000/reprocess' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

DELETE/organizations/:orgId/bot/knowledge/:id

bearer

Elimina un documento del knowledge base (chunks y objeto S3).

Path params

orgIdstringrequerido
idstringrequerido

Respuestas

curl -X DELETE 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/knowledge/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}