Archivar una villa
POST /api/v1/properties/{propertyId}/archive
Archiva una villa. En este producto no existe la eliminación: archivar es un cambio de estado, y las reservas pasadas siguen vinculadas a la villa.
Una villa archivada desaparece de los caminos de reserva — ya no se ofrece, y un intento de reserva
en ella se rechaza con PROPERTY_NOT_BOOKABLE.
Idempotente: archivar una villa ya archivada responde 200 y no cambia nada.
Autorización
| Rol en la organización | Este endpoint |
|---|---|
owner | Permitido |
admin | Permitido |
member | Rechazado — 403 |
Cuerpo de la petición
Ninguno.
Ejemplo
bash
curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/properties/1f0a…/archive"Respuesta
200 OK— la villa,status: "archived".
Qué rechaza
403 Forbidden— el portador de la clave es unmember.401 Unauthorized— clave ausente o no válida, o clave cuyo portador ha dejado la organización.404 Not Found— identificador desconocido, o identificador que pertenece a otra organización. Los dos son deliberadamente indistinguibles.429 Too Many Requests— más de 120 peticiones en un minuto para esta clave.
Irreversible por la API. Restaurar una villa se hace desde la aplicación. Un agente no archiva una villa sin la autorización humana explícita para ese gesto exacto.