*MCP › Referencia › Alquileres › Proyectos*

# Archivar o restaurar un proyecto

> Saca el proyecto de las vistas activas o lo devuelve a ellas.

No borra nada y no toca ni los pedidos, ni los documentos, ni el equipo: solo la visibilidad. Solo se puede archivar un proyecto en borrador o cancelado (409 en otro caso); restaurar siempre está permitido. PUT porque la llamada FIJA el valor —no hay alternancia—, así que repetirla no hace nada nuevo. Responde 204 sin cuerpo. Un proyecto archivado queda fuera del listado salvo que se pase `archived=true`; su GET sigue respondiendo con `archived: true`.

HERRAMIENTA `filmo_projects_archive` · `projects:write` · 120/min · Anotación del servidor: Idempotente

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `projectId` | string | Sí | Identificador del proyecto. |
| `archived` | boolean | Sí | true retira el proyecto de las vistas activas; false lo recupera. |
| `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`.

*Llamada · filmo_projects_archive*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_projects_archive",
    "arguments": {
      "projectId": "proj_8f2a1c",
      "archived": true
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": "<value>",
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}
```

## La misma operación por REST

Esta herramienta ejecuta [`PUT /api/v1/projects/{projectId}/archive`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/archive-or-restore-a-project).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/projects/filmo-projects-archive  
Última actualización: 2026-10-25