Renombrar una villa
PATCH /api/v1/properties/{propertyId}
Renombra una villa. Nada más cambia: la foto, el estado de archivo y la tarifa por noche son gestos separados, a propósito — renombrar no debe borrar una foto sin avisar.
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 |
Ejemplo
bash
curl -X PATCH -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
-d '{"name":"Villa Suar — Beachfront"}' \
"https://villaslot.app/api/v1/properties/1f0a…"Respuesta
200 OK— la villa actualizada.
Qué rechaza
403 Forbidden— el portador de la clave es unmember.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.