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ónLlamada
Listar las tareas programadasGET /tasksGratis
Obtener una tarea programadaGET /tasks/{taskId}Gratis
Crear una tarea programadaPOST /tasksGratis
Modificar una tarea programadaPATCH /tasks/{taskId}Gratis
Eliminar una tarea programadaDELETE /tasks/{taskId}Gratis
Lanzar una tarea programadaPOST /tasks/{taskId}/runDe pago
Listar las ejecuciones de una tarea programadaGET /tasks/{taskId}/runsGratis

Listar las tareas programadas

GET/tasksGratis

Todas las tareas programadas del espacio: su mensaje, su horario, su estado, su próxima y su última ejecución.

Herramienta MCP list_scheduled_tasks

Petición
curl https://app.semchat.io/api/v1/tasks \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Obtener una tarea programada

GET/tasks/{taskId}Gratis

Una tarea programada.

Herramienta MCP get_scheduled_task

ArgumentoTipoDescripción
taskIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Crear una tarea programada

POST/tasksGratis

Crea 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

ArgumentoTipoDescripción
nameobligatoriostringEl nombre de la tarea, tal como lo muestra la lista.1–120 caracteres
promptobligatoriostringEl 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
scheduleobligatoriostring | nullCuá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).
timezoneobligatoriostringLa zona horaria de sus horas, p. ej. "Europe/Paris".
site_idopcionalstring | nullEl sitio del que trata, para la lista (null: ninguno). Por defecto, el primer sitio que nombra su mensaje.
Petición
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

PATCH/tasks/{taskId}Gratis

Cambia 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

ArgumentoTipoDescripción
taskIden la rutastringSu id.
nameopcionalstringEl nombre de la tarea, tal como lo muestra la lista.1–120 caracteres
promptopcionalstringEl 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
scheduleopcionalstring | nullCuá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).
timezoneopcionalstringLa zona horaria de sus horas, p. ej. "Europe/Paris".
site_idopcionalstring | nullEl sitio del que trata, para la lista (null: ninguno). Por defecto, el primer sitio que nombra su mensaje.
statusopcionalstring"paused": deja de ejecutarse; "active": se reanuda (su contador de errores vuelve a cero).active | paused
Petición
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

DELETE/tasks/{taskId}Gratis

Elimina 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

ArgumentoTipoDescripción
taskIden la rutastringSu id.
Petición
curl -X DELETE https://app.semchat.io/api/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk_live_…"

Responde 204 con { "data": … }.

Lanzar una tarea programada

POST/tasks/{taskId}/runDe pago

Lanza 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

ArgumentoTipoDescripción
taskIden la rutastringSu id.
Petición
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

GET/tasks/{taskId}/runsGratis

Las ú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

ArgumentoTipoDescripción
taskIden la rutastringSu id.
Petición
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.

¿Listo para impulsar tu web?

Haz tu primera pregunta - semchat te responde con un plan de acción claro en segundos.

Gratis · sin registro · en 5 segundos