Mettre un transfert en pause
============================

.. http:put:: /api/transfers/(int:transfer_id)/pause

   Pause le transfert portant l'identifiant ``transfer_id``. Le transfert
   doit être en cours ou planifié.

   :reqheader Authorization: Les identifiants de l'utilisateur

   :statuscode 201: Le transfert a été mis en pause avec succès
   :statuscode 400: Le transfert demandé ne peut pas être mis en pause
   :statuscode 401: Authentification d'utilisateur invalide
   :statuscode 404: Le transfert demandé n'existe pas

   :resheader Location: Le chemin d'accès au transfert redémarré


   |

   **Exemple de requête**

      .. code-block:: http

         PUT https://my_waarp_transfer.net/api/transfers/1/pause HTTP/1.1
         Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

   **Exemple de réponse**

      .. code-block:: http

         HTTP/1.1 201 CREATED
         Location: https://my_waarp_transfer.net/api/transfers/1