Archiver une villa
POST /api/v1/properties/{propertyId}/archive
Archive une villa. Il n’y a pas de suppression dans ce produit : l’archivage est un changement d’état, et les réservations passées restent rattachées à la villa.
Une villa archivée disparaît des chemins de réservation — elle n’est plus proposée, et une tentative de
réservation sur elle est refusée avec PROPERTY_NOT_BOOKABLE.
Idempotent : archiver une villa déjà archivée répond 200 et ne change rien.
Autorisation
| Rôle dans l’organisation | Cet endpoint |
|---|---|
owner | Autorisé |
admin | Autorisé |
member | Refusé — 403 |
Corps de la requête
Aucun.
Exemple
bash
curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/properties/1f0a…/archive"Réponse
200 OK— la villa,status: "archived".
Ce qu’il refuse
403 Forbidden— le porteur de la clé est unmember.401 Unauthorized— clé absente ou invalide, ou clé dont le porteur a quitté l’organisation.404 Not Found— identifiant inconnu, ou identifiant appartenant à une autre organisation. Les deux sont volontairement indiscernables.429 Too Many Requests— plus de 120 requêtes en une minute pour cette clé.
Irréversible par l’API. La réactivation d’une villa se fait depuis l’application. Un agent n’archive pas une villa sans un feu vert humain explicite pour ce geste précis.