Archivar y eliminar

Cada operación que elimina o retira un registro pertenece a uno de cinco grupos. La tabla siguiente se genera a partir de la especificación y marca también qué operaciones la especificación califica de irreversibles o finales.

Estas descripciones lo dicen de forma explícita, o califican el resultado de bloqueado o terminal. Trata cada una como final.

POST /api/v1/orders/{orderId}/unreserve no está en esta lista. Devuelve el pedido a borrador y el pedido se puede volver a reservar, pero elimina las tareas de entrega y devolución que creó la reserva, y estas no se recrean a mano.

Antes de llamar a cualquiera de estas desde un agente o un script, lee la página de la operación y considera enviar tu propio clave de idempotencia y, en las operaciones que aceptan If-Match (todas las anteriores salvo DELETE /api/v1/tags/{tagId} y DELETE /api/v1/availability/unavailabilities/{unavailabilityId}), el ETag que has leído, de modo que una vista obsoleta no pueda desencadenar la acción.

PUT /api/v1/orders/{orderId}/archive archiva o restaura un pedido: el cuerpo es { "archived": true } o { "archived": false }. Es un PUT que fija un valor, no hay alternancia, y responde 204 sin cuerpo. La especificación dice que repetir la llamada no hace nada nuevo, pero no cuentes con que updatedAt se quede quieto: una repetición todavía puede actualizarlo, así que el pedido puede volver a aparecer en una lectura incremental.

• Solo se puede archivar un pedido en borrador o cancelado. Cualquier otro estado responde 409 conflict, indicando el estado.
• Un pedido archivado deja de ser visible para la API: su GET responde 404, igual que con un pedido que no existe, se excluye de las listas y no hay ninguna opción includeArchived.
• Para restaurar un pedido, llama a PUT /api/v1/orders/{orderId}/archive con archived: false y el id que guardaste: mientras el pedido está archivado no puedes listarlo ni leerlo. Tras el 204 vuelve a leerse con su GET.
• OrderDto.status lista archived como valor posible, pero Filmo nunca lo produce: archivar no cambia el estado.

Los proyectos se comportan de otra manera. PUT /api/v1/projects/{projectId}/archive también acepta solo un proyecto en borrador o cancelado, pero un proyecto archivado solo se oculta del listado: archived con valor true lista solo los archivados, y su GET sigue respondiendo con archived: true.

Algunos borrados se niegan a ejecutarse cuando algo todavía usa el registro. contact_in_use y address_in_use devuelven 409 y no borran nada; errors[] tiene una entrada por cada tipo de registro que lo usa, con un count. Mueve o elimina antes esos registros, o archiva el contacto en su lugar.