Référence APIRetirer le mot de passe d'un transfert
DELETE/v1/transfers/{id}/password

Retirer le mot de passe d'un transfert

Supprime la protection par mot de passe d'un transfert et le rend accessible sans saisie.

1 min de lectureTélécharger en PDF

Réponse exemple

{
"short_code": "x7Qa9R",
"transfer_id": "tr_9fK3m2Qz8vWp",
"password_removed": true
}
DELETE/v1/transfers/{id}/passwordRetire le mot de passe d'un transfert et désactive sa protection à l'accès.

Cet endpoint retire le mot de passe d'un transfert : le hachage stocké est mis à null et is_password_protected repasse à false. Le transfert redevient alors accessible via son lien public sans saisie de mot de passe. L'opération est idempotente : appeler DELETE sur un transfert déjà non protégé réussit également tant que le transfert existe. Aucun corps de requête n'est attendu.

Authentification

Requiert une clé API valide avec le scope transfers:write. La mise à jour est filtrée sur le workspace_id du contexte d'authentification : un transfert appartenant à un autre workspace est introuvable et renvoie 404 not_found.

Réponse

Renvoie un objet JSON de confirmation. transfer_id reprend l'identifiant de l'URL, short_code est le code court public du transfert, et password_removed vaut toujours true en cas de succès.

ChampTypeDescription
transfer_idstringIdentifiant du transfert mis à jour.
short_codestringCode court public du transfert.
password_removedbooleanToujours true lorsque la protection a bien été retirée.

Erreurs

CodeQuandRésolution
404 not_foundAucun transfert ne correspond à cet id dans le workspace de la clé.Vérifier l'identifiant et que le transfert appartient bien au workspace.
500 internal_errorÉchec de la mise à jour en base.Réessayer ; si l'erreur persiste, contacter le support avec le request_id.

Voir aussi

  • PUT /v1/transfers/{id}/password : définir ou modifier le mot de passe.
  • GET /v1/transfers/{id} : consulter l'état d'un transfert, dont is_password_protected.
  • DELETE /v1/transfers/{id} : supprimer le transfert.