Réponse exemple
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.
| Champ | Type | Description |
|---|---|---|
| transfer_id | string | Identifiant du transfert mis à jour. |
| short_code | string | Code court public du transfert. |
| password_removed | boolean | Toujours true lorsque la protection a bien été retirée. |
Erreurs
| Code | Quand | Résolution |
|---|---|---|
| 404 not_found | Aucun 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, dontis_password_protected. - DELETE
/v1/transfers/{id}: supprimer le transfert.