Passer au contenu principal
POST
Changer les dates d’une location

Autorisations

Authorization
string
header
requis

Clé API lck_… créée dans Lexio (Paramètres → Développeur), envoyée en Authorization: Bearer. Voir Authentification.

En-têtes

Idempotency-Key
string
requis

Clé unique de l’opération, réutilisée à chaque nouvel essai : un rejeu avec la même clé et le même corps renvoie la réponse initiale sans rien réécrire. Voir Idempotence. Facultative avec ?dryRun=true sur les opérations qui l’acceptent.

Required string length: 1 - 255
Pattern: ^[\x20-\x7E]+$
Exemple:

"8b3e1d2c-4a5f-4c6b-9e7d-1f2a3b4c5d6e"

Paramètres de chemin

rentalId
string<uuid>
requis

Identifiant de la location.

Exemple:

"9c2d7e4a-5b1f-4d3c-8a6e-0f1b2c3d4e5f"

Paramètres de requête

dryRun
enum<string>

true : aperçu, la même action annulée en fin de transaction.

Options disponibles:
true,
false

Corps

application/json
startAt
string

Nouveau départ, heure murale de l’agence sans décalage (YYYY-MM-DDTHH:MM). Omis : inchangé. Refusé sur une location IN_PROGRESS (409 RENTAL_STATUS_NOT_ALLOWED, pointer /startAt).

Exemple:

"2026-11-10T10:00"

endAt
string

Nouveau retour, même format : l’heure est toujours celle envoyée, jamais la fermeture de l’agence. Omis : inchangé.

Exemple:

"2026-11-10T10:00"

expectedTotalTTC
number

Total TTC affiché par l’aperçu (dryRun). Écart d’au moins une unité mineure avec le total recalculé → 409 PRICE_CHANGED.

overpaymentResolution
enum<string>

REFUND_PENDING : remboursement PENDING par virement du trop-perçu ; NO_REFUND : le loueur le conserve. Exige le scope payments.refund.

Options disponibles:
REFUND_PENDING,
NO_REFUND

Réponse

Changer les dates d’une location

data
object
requis

Location, dans la même représentation pour la lecture, la liste et chaque écriture. Montants dans currency, voir Montants et TVA.

Exemple:
effects
object
requis