Objekte

Objekt ändern

patchhttps://open-api.mynextdays.com/v1/properties/{property_id}

Beschreibende Felder eines Objekts ändern.

Absichtlich auf Titel, Beschreibung, Belegungsgrenze und Ausstattung begrenzt. Was den Verkauf steuert — Status, Kanal-Sichtbarkeit, Preise, Verfügbarkeit — hat eigene Endpunkte mit eigenen Scopes. Ein Sammel-PATCH, der alles kann, macht jede Rechtevergabe stumpf: wer eine Beschreibung pflegen soll, könnte damit ein Objekt aus dem Verkauf nehmen.

Pfad-Parameter

property_idstringpflicht

Anfrage-Körperpflicht

amenitiesarray of string

descriptionstring

max_guestsinteger

titlestring

Antworten

200Successful Response

addressAddresspflicht

Adresse in Einzelfeldern (street, house_number, postal_code, city, country).

amenitiesarray of string

building_idstring

Gebäude, unter dem dieses Objekt bei den Portalen geführt wird. Mehrere Objekte desselben Gebäudes teilen dort eine Kennung.

category_slugstring

channelsChannelspflicht

Kanal-Sichtbarkeit, je Kanal einzeln: marketplace (myBestDays), website (eigene Seite). Es gibt kein globales „veröffentlicht-Flag.

created_atdate-timepflicht

currencystringpflicht

Währungscode (ISO 4217) dieses Objekts.

idstringpflicht

latnumber

listing_typestring

entire_place | private_room | shared_room.

lngnumber

max_guestsintegerpflicht

photosarray of string

property_typestring

statusstringpflicht

Nur active ist verkäuflich. draft ist unfertig, inactive aus dem Verkauf genommen.

Erlaubt:draftactiveinactive

subtype_slugstring

timezonestring

Zeitzone des Objekts (IANA). Kalendertage beziehen sich darauf.

titlestringpflicht

units_totalintegerpflicht

Zahl der Einheiten dieses Typs (mindestens 1).

updated_atdate-timepflicht

422Validation Error

detailarray of ValidationError

ctxContext

inputInput

locarray of string | integerpflicht

msgstringpflicht

typestringpflicht

Sprache

Zugang

Nur in diesem Browser, nur für „Ausprobieren“ — der Wert wird nicht gespeichert und nicht an uns geschickt.

Anfrage

curl -X PATCH 'https://open-api.mynextdays.com/v1/properties/%3Cproperty_id%3E' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "amenities": [
    "…"
  ],
  "description": "…",
  "max_guests": 1,
  "title": "…"
}'

Ohne Token antwortet der Aufruf mit 401 — das ist der erwartete Weg.

Beispiel

{
  "id": "…",
  "title": "…",
  "status": "draft",
  "currency": "…",
  "max_guests": 1,
  "units_total": 1,
  "address": {},
  "channels": {},
  "created_at": "2026-09-10T14:00:00Z",
  "updated_at": "2026-09-10T14:00:00Z"
}