Tareas

Actualizar una tarea

Actualiza parcialmente una tarea (envía solo los campos que cambian).

Herramienta

filmo_tasks_update

Escrituratasks:write

tasks:write
120/min
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_tasks_update",
    "arguments": {
      "taskId": "task_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "title": "Example",
      "description": "<description>",
      "startDate": "2026-09-01T08:00:00Z",
      "endDate": "2026-09-01T08:00:00Z",
      "isAllDay": true,
      "isCompleted": true,
      "isRecurring": true,
      "recurringGroupId": "recu_8f2a1c",
      "recurrencePattern": {
        "frequency": "daily",
        "interval": 1,
        "endAfterOccurrences": 1,
        "endDate": "2026-09-01T08:00:00Z"
      },
      "type": "<type>",
      "assignedStaffIds": [
        "assi_8f2a1c"
      ],
      "projectId": "proj_8f2a1c",
      "relatedDocumentId": "rela_8f2a1c",
      "relatedDocumentType": "<relatedDocumentType>",
      "appearance": {
        "color": "<color>",
        "variant": "primary"
      },
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

El personal, el proyecto y el documento relacionado se comprueban contra tu cuenta igual que en la creación. Devuelve la tarea actualizada.

Argumentos

taskIdstringObligatorio

Identificador de la tarea.

Límites: longitud mín. 1

titlestring

Título de la tarea.

Límites: longitud mín. 1, longitud máx. 300

descriptionstring | null

Descripción o notas de la tarea; null las borra.

Límites: longitud máx. 5000

startDatestring<date-time>

Fecha y hora de inicio de la tarea (ISO 8601 con desplazamiento).

endDatestring<date-time> | null

Fecha y hora de fin de la tarea (ISO 8601 con desplazamiento); debe ser igual o posterior a startDate. null la borra.

isAllDayboolean

Si la tarea dura todo el día.

isCompletedboolean

Marca la tarea como completada o pendiente.

typestring

Tipo de tarea: su identificador o su nombre, comparado sin distinguir mayúsculas ni acentos (ver POST /api/v1/tasks). Cambiarlo también cambia el color de la tarea al del tipo.

Límites: longitud mín. 1, longitud máx. 100

assignedStaffIdsstring[]

Identificadores del personal asignado a la tarea (máx. 50); sustituye la asignación existente.

Límites: máx. 50 elementos, cada uno: longitud mín. 1, cada uno: longitud máx. 100

projectIdstring | null

Identificador del proyecto vinculado; null lo desvincula.

Límites: longitud mín. 1, longitud máx. 100

relatedDocumentIdstring | null

Identificador del documento relacionado; va siempre junto con relatedDocumentType. null (con relatedDocumentType: null) lo desvincula.

Límites: longitud mín. 1, longitud máx. 100

relatedDocumentTypestring | null

Tipo del documento relacionado; va siempre junto con relatedDocumentId. null (con relatedDocumentId: null) lo desvincula.

Opciones disponibles: contact, order, item, kit, space, collection, invoice, quote, purchaseOrder, supplierInvoice, incident, repairTicket, project, vehicle, staff, service, opportunity

idempotencyKeystring

Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.

Límites: longitud mín. 1, longitud máx. 255

ifMatchstring

Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones.

Límites: longitud mín. 1

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data

idstring

Identificador único de la tarea.

titlestring

Título de la tarea.

descriptionstring | null

Descripción o notas de la tarea; null si no tiene.

startDatestring<date-time>

Fecha y hora de inicio en ISO 8601 con desplazamiento.

endDatestring<date-time> | null

Fecha y hora de fin en ISO 8601 con desplazamiento; null si no tiene un fin definido.

isAllDayboolean

Si la tarea dura todo el día.

isCompletedboolean

Si la tarea está completada.

isRecurringboolean

Si la tarea forma parte de una serie recurrente.

recurringGroupIdstring | null

Identificador del grupo de recurrencia al que pertenece; null si no es recurrente.

recurrencePatternobject | null

Patrón de recurrencia de la tarea; null si no es recurrente.

Mostrar atributos hijos

recurrencePattern.frequencystring

Frecuencia de recurrencia: daily, weekly, monthly o yearly.

Opciones disponibles: daily, weekly, monthly, yearly

recurrencePattern.intervalinteger

Intervalo entre repeticiones según la frecuencia (p. ej. 2 con weekly = cada dos semanas).

recurrencePattern.endAfterOccurrencesinteger | null

Número de repeticiones tras las cuales termina la recurrencia; null si no termina por número de ocurrencias.

recurrencePattern.endDatestring<date-time> | null

Fecha en que termina la recurrencia, en ISO 8601 con desplazamiento; null si no termina por fecha.

typestring

Tipo de tarea (identificador del tipo).

assignedStaffIdsstring[]

Identificadores del personal asignado a la tarea.

projectIdstring | null

Identificador del proyecto vinculado; null si la tarea no está vinculada.

relatedDocumentIdstring | null

Identificador del documento relacionado; null si no tiene.

relatedDocumentTypestring | null

Tipo del documento relacionado (contacto, pedido, factura, presupuesto, proyecto, etc.); null si no tiene.

appearanceobject

Aspecto de la tarea en la agenda (color y variante).

Mostrar atributos hijos

appearance.colorstring

Color de la tarea en la agenda (código hexadecimal).

appearance.variantstring

Variante visual de la tarea: primary, secondary, destructive o default.

Opciones disponibles: primary, secondary, destructive, default

createdAtstring<date-time>

Fecha de creación en ISO 8601 con desplazamiento.

updatedAtstring<date-time>

Fecha de la última actualización en ISO 8601 con desplazamiento.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta PATCH /api/v1/tasks/{taskId}.

Tareas
Actualizar una tarea
Actualiza parcialmente una tarea (envía solo los campos que cambian).
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

La misma operación por REST

Páginas relacionadas

Actualizar una tarea

Escrituras seguras

Errores