DELETE
Retirer une option

Autorisations

X-Api-Key
string
header
requis

Clé API liée à un groupe (med_live_… en production, med_test_… en test). Fournie en clair une seule fois à la création depuis le profil client.

Paramètres de chemin

id
string
requis

Identifiant de la mission (offer_id).

option_key
string
requis

Clé de l'option à retirer (URL-encodée).

Paramètres de requête

leg
enum<string>

Jambe visée (aller par défaut). Une autre valeur renvoie 422 ; retour sur une mission sans trajet retour renvoie 422 (code: no_return_leg).

Options disponibles:
aller,
retour

Réponse

Option retirée, prix recalculé.

new_price
number | null
requis
delta
number | null
requis
option
string

Clé effectivement retirée.

leg
enum<string>
Options disponibles:
aller,
retour
removed
string[]
derived
string[]
warnings
string[]
driver_validation
object

Sort du convoyeur attribué après la modification (#1725).

Dès qu'un convoyeur est attribué et que la mission n'est pas encore partie, toute modification faite avec une clé partenaire lui demande de valider les nouvelles modalités (mode: ask). Il reçoit une notification et doit accepter ou refuser depuis l'application MED.

En cas de refus, le convoyeur est retiré de la mission, qui repart en ligne : prévoyez ce cas dans votre intégration, en écoutant l'événement transport.driver_validation_requested puis le statut de la mission. Sans réponse après trois relances, le convoyeur est également retiré.

mode: none signifie qu'il n'y avait personne à solliciter (mission non attribuée, ou déjà enlevée).