DocumentaciónReferencia de la API
Tareas programadas
Las tareas programadas: crearlas, cambiarlas, lanzarlas ahora y leer sus ejecuciones.
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 | |
|---|---|---|
| Listar las tareas programadas | GET /tasks | Gratis |
| Obtener una tarea programada | GET /tasks/{taskId} | Gratis |
| Crear una tarea programada | POST /tasks | Gratis |
| Modificar una tarea programada | PATCH /tasks/{taskId} | Gratis |
| Eliminar una tarea programada | DELETE /tasks/{taskId} | Gratis |
| Lanzar una tarea programada | POST /tasks/{taskId}/run | De pago |
| Listar las ejecuciones de una tarea programada | GET /tasks/{taskId}/runs | Gratis |
Listar las tareas programadas
/tasksGratisTodas las tareas programadas del espacio: su mensaje, su horario, su estado, su próxima y su última ejecución.
Herramienta MCP list_scheduled_tasks
curl https://app.semchat.io/api/v1/tasks \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Obtener una tarea programada
/tasks/{taskId}GratisUna tarea programada.
Herramienta MCP get_scheduled_task
| Argumento | Tipo | Descripción |
|---|---|---|
taskIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Crear una tarea programada
/tasksGratisCrea una tarea programada: un mensaje que el asistente ejecuta solo según un horario, como en Tareas de la aplicación.
- Empieza activa: su primera ejecución es en la siguiente hora del horario.
- Cada ejecución es una conversación del espacio, facturada como un mensaje del chat. Una acción que sale de semchat (publicar, enviar un mensaje) y que su mensaje pide se hace al momento, como en cualquier chat.
Herramienta MCP create_scheduled_task
| Argumento | Tipo | Descripción |
|---|---|---|
nameobligatorio | string | El nombre de la tarea, tal como lo muestra la lista.1–120 caracteres |
promptobligatorio | string | El mensaje que el asistente ejecuta cada vez, escrito como en el chat. Puede nombrar un sitio («/site:example.com»: sus datos y sus conectores), una habilidad («/<skill-id>»), una dirección de correo («/email:paul@example.com»), un canal de Discord («/discord:<id>»), una cuenta de Slack o de Notion («/slack:<id>», «/notion:<id>»).1–8000 caracteres |
scheduleobligatorio | string | null | Cuándo se ejecuta: { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (en un mes más corto: su último día), o { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 o 12). |
timezoneobligatorio | string | La zona horaria de sus horas, p. ej. "Europe/Paris". |
site_idopcional | string | null | El sitio del que trata, para la lista (null: ninguno). Por defecto, el primer sitio que nombra su mensaje. |
curl -X POST https://app.semchat.io/api/v1/tasks \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…", "prompt": "…", "schedule": "…", "timezone": "…"}'Responde 201 con { "data": … }.
Modificar una tarea programada
/tasks/{taskId}GratisCambia una tarea programada: su nombre, su mensaje, su horario, su zona horaria o su sitio, o la pausa y la reanuda (status).
- Solo su autor, o el propietario o un administrador del espacio, puede cambiar, lanzar o eliminar una tarea: si no, 403 FORBIDDEN.
- Solo cambian los campos indicados; hace falta al menos uno. Un nuevo horario o una nueva zona horaria, o una reanudación, mueve la próxima ejecución a la siguiente hora del horario a partir de ahora.
Herramienta MCP update_scheduled_task
| Argumento | Tipo | Descripción |
|---|---|---|
taskIden la ruta | string | Su id. |
nameopcional | string | El nombre de la tarea, tal como lo muestra la lista.1–120 caracteres |
promptopcional | string | El mensaje que el asistente ejecuta cada vez, escrito como en el chat. Puede nombrar un sitio («/site:example.com»: sus datos y sus conectores), una habilidad («/<skill-id>»), una dirección de correo («/email:paul@example.com»), un canal de Discord («/discord:<id>»), una cuenta de Slack o de Notion («/slack:<id>», «/notion:<id>»).1–8000 caracteres |
scheduleopcional | string | null | Cuándo se ejecuta: { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (en un mes más corto: su último día), o { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 o 12). |
timezoneopcional | string | La zona horaria de sus horas, p. ej. "Europe/Paris". |
site_idopcional | string | null | El sitio del que trata, para la lista (null: ninguno). Por defecto, el primer sitio que nombra su mensaje. |
statusopcional | string | "paused": deja de ejecutarse; "active": se reanuda (su contador de errores vuelve a cero).active | paused |
curl -X PATCH https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'Responde 200 con { "data": … }.
Eliminar una tarea programada
/tasks/{taskId}GratisElimina una tarea programada. Sus ejecuciones pasadas y sus conversaciones se quedan.
- Solo su autor, o el propietario o un administrador del espacio, puede cambiar, lanzar o eliminar una tarea: si no, 403 FORBIDDEN.
Herramienta MCP delete_scheduled_task
| Argumento | Tipo | Descripción |
|---|---|---|
taskIden la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Responde 204 con { "data": … }.
Lanzar una tarea programada
/tasks/{taskId}/runDe pagoLanza una tarea programada ahora, como «Lanzar ahora» en la aplicación: una ejecución, sin cambiar su horario.
- Solo su autor, o el propietario o un administrador del espacio, puede cambiar, lanzar o eliminar una tarea: si no, 403 FORBIDDEN.
- Responde al momento con el id de la ejecución; la ejecución continúa en segundo plano: consulta list_scheduled_task_runs para ver su conversación y su resumen.
- 409 CONFLICT mientras una de sus ejecuciones esté en curso; 402 INSUFFICIENT_TOKENS sin créditos.
Herramienta MCP run_scheduled_task
| Argumento | Tipo | Descripción |
|---|---|---|
taskIden la ruta | string | Su id. |
curl -X POST https://app.semchat.io/api/v1/tasks/{taskId}/run \
-H "Authorization: Bearer sk_live_…"Responde 202 con { "data": … }.
Listar las ejecuciones de una tarea programada
/tasks/{taskId}/runsGratisLas últimas ejecuciones de una tarea programada, de la más reciente a la más antigua: el estado de cada una, su conversación, su título y su resumen.
Herramienta MCP list_scheduled_task_runs
| Argumento | Tipo | Descripción |
|---|---|---|
taskIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/tasks/{taskId}/runs \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
¿No encuentras la respuesta? Escríbenos.

