DocumentaciónReferencia de la API
Conversaciones
Las conversaciones del espacio o de un sitio, sus mensajes, y cómo enviar uno.
Cada operación de esta página es también una herramienta MCP, con el mismo nombre. Las marcadas Gratis no cuestan nada; las marcadas De pago usan los créditos del espacio, como en la aplicación (Cuánto cuesta).
| Operación | Llamada | |
|---|---|---|
| Modificar una conversación | PATCH /conversations/{cid} | Gratis |
| Eliminar una conversación | DELETE /conversations/{cid} | Gratis |
| Listar las conversaciones | GET /conversations | Gratis |
| Crear una conversación | POST /conversations | Gratis |
| Obtener una conversación | GET /conversations/{cid} | Gratis |
| Listar los mensajes | GET /conversations/{cid}/messages | Gratis |
| Enviar un mensaje | POST /conversations/{cid}/messages | De pago |
| Listar los documentos de una conversación | GET /conversations/{cid}/documents | Gratis |
| Listar las conversaciones de un sitio | GET /sites/{siteId}/conversations | Gratis |
| Crear una conversación en un sitio | POST /sites/{siteId}/conversations | Gratis |
| Obtener una conversación de un sitio | GET /sites/{siteId}/conversations/{cid} | Gratis |
| Listar los mensajes de un sitio | GET /sites/{siteId}/conversations/{cid}/messages | Gratis |
| Enviar un mensaje en un sitio | POST /sites/{siteId}/conversations/{cid}/messages | De pago |
Modificar una conversación
/conversations/{cid}GratisRenombra una conversación, o la marca o desmarca con una estrella.
- Actúa sobre cualquier conversación del espacio, incluidas las de un sitio (basta con su cid), como hace la aplicación.
- Solo cambian los campos indicados. Responde con la conversación.
Herramienta MCP update_conversation
| Argumento | Tipo | Descripción |
|---|---|---|
ciden la ruta | string | Su id. |
titleopcional | string | Renombra la conversación.1–500 caracteres |
starredopcional | boolean | true la marca con una estrella (starred_at = ahora), false se la quita. |
curl -X PATCH https://app.semchat.io/api/v1/conversations/{cid} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'Responde 200 con { "data": … }.
Eliminar una conversación
/conversations/{cid}GratisElimina una conversación.
- Actúa sobre cualquier conversación del espacio, incluidas las de un sitio (basta con su cid), como hace la aplicación.
- Borrado lógico, como en la aplicación: sale de las listas y responde 404; sus mensajes y los datos guardados a partir de ella se conservan.
Herramienta MCP delete_conversation
| Argumento | Tipo | Descripción |
|---|---|---|
ciden la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/conversations/{cid} \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Listar las conversaciones
/conversationsGratisLas conversaciones del espacio (no vinculadas a un sitio).
Herramienta MCP list_conversations
curl https://app.semchat.io/api/v1/conversations \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a163c9-4920-773f-89fb-75ff608e07fe",
"title": "Audit complet d'alpha",
"site_id": null,
"message_count": 2,
"starred_at": "2026-10-22T13:31:58.000Z",
"last_message_at": "2026-10-22T13:26:58.000Z",
"created_at": "2026-10-22T13:24:58.000Z",
"updated_at": "2026-10-22T13:26:58.000Z"
},
{
"id": "01a15ea2-ed20-7a5d-a415-afcd68358a91",
"title": "Idées de contenu",
"site_id": null,
"message_count": 2,
"starred_at": "2026-10-21T13:31:58.000Z",
"last_message_at": "2026-10-21T13:26:58.000Z",
"created_at": "2026-10-21T13:24:58.000Z",
"updated_at": "2026-10-21T13:26:58.000Z"
}
]
}Crear una conversación
/conversationsGratisEmpieza una conversación del espacio.
Herramienta MCP create_conversation
| Argumento | Tipo | Descripción |
|---|---|---|
titleopcional | string | Su título (opcional).hasta 500 caracteres |
curl -X POST https://app.semchat.io/api/v1/conversations \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'Responde 201 con { "data": … }.
Obtener una conversación
/conversations/{cid}GratisUna conversación del espacio (incluidas las de un sitio).
Herramienta MCP get_conversation
| Argumento | Tipo | Descripción |
|---|---|---|
ciden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/conversations/{cid} \
-H "Authorization: Bearer sk_live_…"{
"data": {
"id": "01a163c9-4920-773f-89fb-75ff608e07fe",
"title": "Audit complet d'alpha",
"site_id": null,
"message_count": 2,
"starred_at": "2026-10-22T13:31:58.000Z",
"last_message_at": "2026-10-22T13:26:58.000Z",
"created_at": "2026-10-22T13:24:58.000Z",
"updated_at": "2026-10-22T13:26:58.000Z"
}
}Listar los mensajes
/conversations/{cid}/messagesGratisLos mensajes de una conversación del espacio, del más antiguo al más reciente (texto, llamadas a herramientas y sus resultados, gráficos, documentos).
Herramienta MCP list_messages
| Argumento | Tipo | Descripción |
|---|---|---|
ciden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/conversations/{cid}/messages \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a15456-3520-7803-9dfd-670569df332f",
"role": "user",
"content": "C'est quoi le SEO ?",
"parts": [
"…"
],
"created_at": "2026-10-19T13:24:58.272Z"
},
{
"id": "01a15456-aa50-78f0-8c72-120a580ca098",
"role": "assistant",
"content": "Le référencement naturel.",
"parts": [
"…",
"…"
],
"created_at": "2026-10-19T13:25:28.272Z"
}
]
}Enviar un mensaje
/conversations/{cid}/messagesDe pagoEnvía un mensaje: el asistente responde usando sus herramientas (datos de palabras clave, rastreo, competidores…) como en la aplicación.
- Los adjuntos se guardan como en la aplicación (cualquier miembro del espacio; un tipo no admitido o un archivo de más de 20 MB es INVALID_INPUT) y llegan al asistente con el mensaje. Una petición pesa 25 MB como máximo: unos 18 MB de archivos una vez codificados en base64.
- La API envía la respuesta en streaming como Server-Sent Events («UI message stream» del Vercel AI SDK); cuando termina, léela completa con la lista de mensajes. Por MCP, la herramienta espera al final y devuelve la respuesta.
- Se factura en créditos exactamente como un turno de chat en la aplicación.
Herramienta MCP send_message
| Argumento | Tipo | Descripción |
|---|---|---|
ciden la ruta | string | Su id. |
messageobligatorio | string | El mensaje del usuario.al menos 1 carácter |
attachmentsopcional | array | Archivos adjuntos al mensaje, como en la aplicación (los mismos tipos, 20 MB cada uno como máximo). |
streamopcional | boolean | Se acepta por compatibilidad; la respuesta de la API siempre llega en streaming. |
curl -X POST https://app.semchat.io/api/v1/conversations/{cid}/messages \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"message": "…"}'La respuesta llega en streaming como Server-Sent Events; cuando termina, léela completa con la lista de mensajes. Por MCP, la herramienta espera al final y devuelve la respuesta.
Listar los documentos de una conversación
/conversations/{cid}/documentsGratisLos documentos escritos en una conversación del espacio.
Herramienta MCP list_conversation_documents
| Argumento | Tipo | Descripción |
|---|---|---|
ciden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/conversations/{cid}/documents \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Listar las conversaciones de un sitio
/sites/{siteId}/conversationsGratisLas conversaciones de un sitio.
Herramienta MCP list_site_conversations
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Crear una conversación en un sitio
/sites/{siteId}/conversationsGratisEmpieza una conversación en un sitio: el asistente conoce ese sitio.
Herramienta MCP create_site_conversation
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
titleopcional | string | Su título (opcional).hasta 500 caracteres |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/conversations \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'Responde 201 con { "data": … }.
Obtener una conversación de un sitio
/sites/{siteId}/conversations/{cid}GratisUna de las conversaciones de un sitio.
Herramienta MCP get_site_conversation
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
ciden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid} \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Listar los mensajes de un sitio
/sites/{siteId}/conversations/{cid}/messagesGratisLos mensajes de una conversación de un sitio, del más antiguo al más reciente.
Herramienta MCP list_site_messages
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
ciden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid}/messages \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Enviar un mensaje en un sitio
/sites/{siteId}/conversations/{cid}/messagesDe pagoEnvía un mensaje en una conversación de un sitio: el asistente responde teniendo en cuenta ese sitio.
- Los adjuntos se guardan como en la aplicación (cualquier miembro del espacio; un tipo no admitido o un archivo de más de 20 MB es INVALID_INPUT) y llegan al asistente con el mensaje. Una petición pesa 25 MB como máximo: unos 18 MB de archivos una vez codificados en base64.
- La API envía la respuesta en streaming como Server-Sent Events («UI message stream» del Vercel AI SDK); cuando termina, léela completa con la lista de mensajes. Por MCP, la herramienta espera al final y devuelve la respuesta.
- Se factura en créditos exactamente como un turno de chat en la aplicación.
Herramienta MCP send_site_message
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
ciden la ruta | string | Su id. |
messageobligatorio | string | El mensaje del usuario.al menos 1 carácter |
attachmentsopcional | array | Archivos adjuntos al mensaje, como en la aplicación (los mismos tipos, 20 MB cada uno como máximo). |
streamopcional | boolean | Se acepta por compatibilidad; la respuesta de la API siempre llega en streaming. |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid}/messages \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"message": "…"}'La respuesta llega en streaming como Server-Sent Events; cuando termina, léela completa con la lista de mensajes. Por MCP, la herramienta espera al final y devuelve la respuesta.
¿No encuentras la respuesta? Escríbenos.

