Créer une villa | VillaSlot Documentation

POST /api/v1/properties

Crée une villa dans l’organisation de la clé. Un organizationId dans le corps est ignoré : le périmètre d’une clé ne se négocie pas.

Une villa toute neuve n’est pas encore réservable — elle n’a ni horaires d’ouverture ni grille tarifaire. Renseignez les deux avant d’essayer de la réserver.

Autorisation

Rôle dans l’organisation	Cet endpoint
`owner`	Autorisé
`admin`	Autorisé
`member`	Refusé — `403`

Corps de la requête

Champ	Type	Obligatoire	Description
`name`	chaîne	oui	De 1 à 120 caractères
`photoUrl`	chaîne	non	L’URL d’une image déjà hébergée. Pour téléverser un fichier, utilisez l’endpoint photo

json

{"name": "Villa Amerta"}

Exemple

bash

curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
  -d '{"name":"Villa Amerta"}' \
  "https://villaslot.app/api/v1/properties"

Réponse

201 Created — la villa créée, status: "active".

Ce qu’il refuse

403 Forbidden — le porteur de la clé est un member, pas un admin.
409 Conflict — la limite de villas de l’offre est atteinte ; le corps porte la limite, l’utilisation et le nom de l’offre. Rien n’a été créé.
422 Unprocessable Entity — le nom est absent ou trop long.
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é.