*MCP › Referencia › Alquileres › Proyectos* # Actualizar un proyecto > Cambia la ficha de un proyecto: nombre, fechas, cliente, tipo, referencia externa, ubicación y color (envía solo los campos que cambian). NO cambia el estado, el archivado ni los pedidos vinculados: los vínculos tienen su propio subrecurso. Un proyecto archivado es de solo lectura: la petición se rechaza con 409 `conflict` y no se escribe nada; desarchívalo antes con [`PUT /api/v1/projects/{projectId}/archive`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/archive-or-restore-a-project) y `archived: false`. El cliente y el tipo de proyecto se comprueban contra la cuenta de la clave de API antes de escribir nada. Devuelve el proyecto completo, con la misma proyección que su GET. HERRAMIENTA `filmo_projects_update` · `projects:write` · 120/min · Anotación del servidor: Idempotente ## Argumentos | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `projectId` | string | Sí | Identificador del proyecto. | | `name` | string | No | Nombre del proyecto. Al menos tres caracteres, como exige el dominio. | | `startDate` | string | No | Inicio del proyecto (ISO 8601 con desplazamiento). | | `endDate` | string | No | Fin del proyecto (ISO 8601 con desplazamiento). No puede ser anterior a startDate; el mismo instante es un proyecto de un día. | | `contactId` | string | No | Cliente del proyecto. Debe pertenecer a la cuenta de la clave de API. | | `projectTypeId` | string | No | Tipo de proyecto; resuélvelo contra `/api/v1/project-types`. null lo borra. | | `externalReference` | string | No | Referencia de formato libre para cruzar el proyecto con un sistema externo; null la borra. | | `location` | object | No | Ubicación física del proyecto (un plató, la sede de un cliente). Solo se registran los campos enviados. | | `location.name` | string | No | Nombre del lugar, por ejemplo "Main stage". | | `location.address` | string | No | Dirección postal. | | `location.city` | string | No | Ciudad. | | `location.postalCode` | string | No | Código postal. | | `location.province` | string | No | Provincia o región. | | `location.country` | string | No | País. | | `location.lat` | number | No | Latitud en grados decimales. | | `location.lng` | number | No | Longitud en grados decimales. | | `color` | string | No | Color de la tarjeta del proyecto (por ejemplo "#3b82f6"); null lo borra. | | `idempotencyKey` | string | No | 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. | | `ifMatch` | string | No | 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. | ## Resultado En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`. | Nombre | Tipo | Descripción | | --- | --- | --- | | `id` | string | Identificador único del proyecto. | | `projectNumber` | string | Número de proyecto legible; null si no está numerado. | | `name` | string | Nombre del proyecto. | | `color` | string | Color asociado al proyecto (para la interfaz); null si no tiene. | | `externalReference` | string | Referencia externa del proyecto (por ejemplo, del sistema del cliente); null si no consta. | | `projectTypeId` | string | Identificador del tipo de proyecto; null si el proyecto no tiene tipo. | | `projectType` | object | Referencia compacta al tipo de proyecto; null si no hay. | | `projectType.id` | string | Identificador único del tipo de proyecto. | | `projectType.name` | string | Nombre del tipo de proyecto. | | `projectType.color` | string | Color asociado al tipo de proyecto (para la interfaz); null si no tiene. | | `contact` | object | Referencia compacta al contacto del proyecto; null si no hay. | | `contact.id` | string | Identificador único del contacto. | | `contact.name` | string | Nombre del contacto. | | `location` | object | Ubicación del proyecto; sus campos internos son null cuando no se han registrado. | | `location.name` | string | Nombre del lugar o ubicación; null si no está registrado. | | `location.address` | string | Dirección de la ubicación; null si no consta. | | `location.city` | string | Ciudad de la ubicación; null si no consta. | | `location.postalCode` | string | Código postal de la ubicación; null si no se ha registrado. | | `location.province` | string | Provincia o región de la ubicación; null si no se ha registrado. | | `location.country` | string | País de la ubicación; null si no consta. | | `location.lat` | number | Latitud de la ubicación; null si no está registrada. | | `location.lng` | number | Longitud de la ubicación; null si no está registrada. | | `startDate` | string | Fecha de inicio del proyecto en ISO 8601 con desplazamiento. | | `endDate` | string | Fecha de fin del proyecto en ISO 8601 con desplazamiento. | | `status` | string | Estado del proyecto: draft, budgeted, confirmed, in_progress, invoiced, completed, cancelled o archived. `archived` es un estado HEREDADO que aparece en datos antiguos; el estado archivado actual se expresa mediante el booleano `archived` de este mismo DTO. `draft`, `budgeted`, `confirmed`, `in_progress`, `invoiced`, `completed`, `cancelled`, `archived` | | `archived` | boolean | Si el proyecto está archivado. | | `orderIds` | string[] | Identificadores de los pedidos del proyecto. El detalle de los pedidos se obtiene en [`GET /api/v1/orders`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-orders)?projectId=. | | `totalOrders` | integer | Número total de pedidos del proyecto (igual a orderIds.length). | | `tags` | object[] | Etiquetas adjuntas al proyecto, con su identificador y nombre. | | `tags.id` | string | Identificador único de la etiqueta. | | `tags.name` | string | Nombre de la etiqueta. | | `customFields` | object | Valores de los campos personalizados por identificador de campo personalizado; las definiciones están en `/api/v1/custom-fields`. | | `source` | string | Origen desde el que se creó el proyecto; null si no consta. | | `createdAt` | string | Fecha de creación en ISO 8601 con desplazamiento. | | `updatedAt` | string | Fecha de la última actualización en ISO 8601 con desplazamiento. | *Llamada · filmo_projects_update* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_projects_update", "arguments": { "projectId": "proj_8f2a1c" } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": { "id": "id_8f2a1c", "projectNumber": "", "name": "Example", "color": "", "externalReference": "", "projectTypeId": "proj_8f2a1c", "projectType": { "id": "id_8f2a1c", "name": "Example", "color": "" }, "contact": { "id": "id_8f2a1c", "name": "Example" }, "location": { "name": "Example", "address": "
", "city": "", "postalCode": "", "province": "", "country": "ES", "lat": 1, "lng": 1 }, "startDate": "2026-09-01T08:00:00Z", "endDate": "2026-09-01T08:00:00Z", "status": "draft", "archived": true, "orderIds": [ "orde_8f2a1c" ], "totalOrders": 1, "tags": [ { "id": "id_8f2a1c", "name": "Example" } ], "customFields": { "key": "" }, "source": "", "createdAt": "2026-09-01T08:00:00Z", "updatedAt": "2026-09-01T08:00:00Z" }, "meta": { "idempotencyKey": "", "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## La misma operación por REST Esta herramienta ejecuta [`PATCH /api/v1/projects/{projectId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/update-a-project). --- URL canónica: https://docs.filmo.io/es/mcp/tools/projects/filmo-projects-update Última actualización: 2026-10-25