Tareas

Crear una tarea

Crea una tarea con validación de dominio: el tipo, el personal, el proyecto y el documento relacionado se comprueban contra tu cuenta, y una referencia ajena responde 400 sin crear nada.

Herramienta

filmo_tasks_create

Escrituratasks:write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_tasks_create",
    "arguments": {
      "title": "Example",
      "startDate": "2026-09-01T08:00:00Z",
      "type": "<type>"
    }
  }
}

{
  "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

Devuelve la tarea creada.

Argumentos

titlestringObligatorio

Título de la tarea. Obligatorio.

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

descriptionstring

Descripción o notas de la tarea.

Límites: longitud máx. 5000

startDatestring<date-time>Obligatorio

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

endDatestring<date-time>

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

isAllDaybooleanpredeterminado:false

Si la tarea dura todo el día. Por defecto es false.

typestringObligatorio

Tipo de tarea: su identificador (tipos de sistema: default, delivery, return, temporaryStock; tipos personalizados: su id, ver /api/v1/task-types) o su nombre, comparado sin distinguir mayúsculas ni acentos. Un nombre que coincide con varios tipos personalizados se rechaza con 400 listando sus identificadores. La tarea toma el color del tipo. Obligatorio.

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

assignedStaffIdsstring[]

Identificadores del personal asignado a la tarea (máx. 50).

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

projectIdstring

Identificador del proyecto al que está vinculada la tarea.

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

relatedDocumentIdstring

Identificador del documento relacionado; va siempre junto con relatedDocumentType.

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

relatedDocumentTypestring

Tipo del documento relacionado (contacto, pedido, artículo, factura, presupuesto, proyecto, etc.); va siempre junto con relatedDocumentId.

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.

Prompts de ejemplo

Crea una tarea para revisar las ópticas del pedido 2026-0142 antes de la recogida.

La misma operación por REST

Esta herramienta ejecuta POST /api/v1/tasks.

Tareas
Crear una tarea
Crea una tarea con validación de dominio: el tipo, el personal, el proyecto y el documento relacionado se comprueban contra tu cuenta, y una referencia ajena responde 400 sin crear nada.
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

Prompts de ejemplo

La misma operación por REST

Páginas relacionadas

Crear una tarea

Escrituras seguras

Errores