Tareas

Listar tareas

Devuelve las tareas y los eventos de la agenda, paginados por cursor.

Herramienta

filmo_tasks_list

Lecturatasks:read

tasks:read
120/min
Anotación del servidor: Solo lectura
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_tasks_list",
    "arguments": {
      "limit": 20
    }
  }
}

{
  "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"
      }
    ],
    "pagination": {
      "nextCursor": "eyJvIjo1MH0",
      "hasMore": true,
      "total": 1
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

Aislamiento estricto por suscripción.

Argumentos

limitintegerpredeterminado:50

Tamaño de página (1-500). Por defecto es 50.

Límites: mín. 1, máx. 500

cursorstring

Cursor opaco de la página que se devuelve. Pasa el valor de pagination.nextCursor de la respuesta anterior; trátalo como opaco.

Límites: longitud máx. 200

sortstring

Orden: hasta 3 campos separados por comas, cada uno con un "-" inicial para descendente (p. ej. "-updatedAt,name"). Campos ordenables: createdAt, updatedAt, startDate, endDate, title, isCompleted, type. Por defecto, "-createdAt". Los empates se resuelven por id, así que el orden es estable entre páginas, y un cursor queda ligado al orden con el que se emitió.

Límites: longitud máx. 200

fromstring<date-time>

Inicio de la ventana de solapamiento (ISO 8601 con desplazamiento): devuelve las tareas que se solapan con [from, to] (cuenta una tarea que empieza antes y termina dentro).

tostring<date-time>

Fin de la ventana de solapamiento (ISO 8601 con desplazamiento): devuelve las tareas que se solapan con [from, to].

assignedStaffIdstring

Filtra por miembro del personal asignado (el mismo identificador que expone assignedStaffIds en el DTO).

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

assignedStaffIdsstring[]

Filtra por assignedStaffId, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos.

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

isCompletedboolean

Filtra por finalización: "true" solo las tareas completadas, "false" solo las tareas pendientes. Omítelo para no aplicar ningún filtro.

typestring

Filtra por tipo de tarea: su identificador (tipos del sistema: default, delivery, return, temporaryStock; tipos personalizados: su id) o su nombre, comparado sin distinguir mayúsculas ni acentos. Un nombre que no coincide con ningún tipo devuelve una lista vacía; uno que coincide con varios se rechaza con 400.

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

typesstring[]

Filtra por type, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos.

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

relatedDocumentIdstring

Filtra por identificador del documento relacionado con la tarea.

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

relatedDocumentIdsstring[]

Filtra por relatedDocumentId, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos.

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

includeTotalbooleanpredeterminado:false

Ponlo en true para incluir pagination.total, el número de resultados que coinciden con los filtros en todas las páginas. Desactivado por defecto.

dateFiltersobject

Filtros de fecha por campo. Una fecha sin hora (YYYY-MM-DD) se lee en la zona horaria del negocio; un instante ISO 8601 con desplazamiento se aplica tal cual con gte, lte, gt y lt, mientras que on lo amplía al día completo del negocio que lo contiene. Campos: created, due, updated.

Mostrar atributos hijos

dateFilters.createdobject

Mostrar atributos hijos

dateFilters.created.gtestring

Desde este día o instante, inclusive.

dateFilters.created.ltestring

Hasta este día o instante, inclusive.

dateFilters.created.gtstring

Estrictamente posterior; una fecha sin hora significa después del final de ese día.

dateFilters.created.ltstring

Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día.

dateFilters.created.onstring

Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene.

dateFilters.dueobject

Mostrar atributos hijos

dateFilters.due.gtestring

Desde este día o instante, inclusive.

dateFilters.due.ltestring

Hasta este día o instante, inclusive.

dateFilters.due.gtstring

Estrictamente posterior; una fecha sin hora significa después del final de ese día.

dateFilters.due.ltstring

Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día.

dateFilters.due.onstring

Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene.

dateFilters.updatedobject

Mostrar atributos hijos

dateFilters.updated.gtestring

Desde este día o instante, inclusive.

dateFilters.updated.ltestring

Hasta este día o instante, inclusive.

dateFilters.updated.gtstring

Estrictamente posterior; una fecha sin hora significa después del final de ese día.

dateFilters.updated.ltstring

Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día.

dateFilters.updated.onstring

Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene.

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

Enséñame las tareas abiertas que vencen esta semana, agrupadas por responsable.

La misma operación por REST

Esta herramienta ejecuta GET /api/v1/tasks.

Tareas
Listar tareas
Devuelve las tareas y los eventos de la agenda, paginados por cursor.
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

Listar tareas

Escrituras seguras

Errores