Crear una villa | VillaSlot Documentation

POST /api/v1/properties

Crea una villa en la organización de la clave. Un organizationId en el cuerpo se ignora: el alcance de una clave no se negocia.

Una villa recién creada todavía no se puede reservar — no tiene horario de apertura ni cuadrícula de tarifas. Define ambos antes de intentar reservarla.

Autorización

Rol en la organización	Este endpoint
`owner`	Permitido
`admin`	Permitido
`member`	Rechazado — `403`

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`name`	cadena	sí	De 1 a 120 caracteres
`photoUrl`	cadena	no	Una URL de imagen ya alojada. Para subir un archivo, usa el endpoint de foto

json

{"name": "Villa Amerta"}

Ejemplo

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"

Respuesta

201 Created — la villa creada, status: "active".

Qué rechaza

403 Forbidden — el portador de la clave es un member, no un admin.
409 Conflict — se ha alcanzado el límite de villas del plan; el cuerpo lleva el límite, el uso y el nombre del plan. No se ha creado nada.
422 Unprocessable Entity — el nombre falta o es demasiado largo.
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.