# Modifier une autorité

PATCH /api/authorities/(string: authority_name)

  Met à jour l’autorité demandée avec les informations renseignées en JSON. Les champs non-spécifiés resteront inchangés.

  En-têtes de requête:

    - Authorization – Les identifiants de l’utilisateur

  Objet JSON de requête:

    - name (string) – Le nom de l’autorité

    - type (string) – Le type d’autorité (TLS, SSH…)

    - publicIdentity (string) – La valeur d’identité publique (certificat, clé publique…) de l’autorité

    - validHosts (array) – La liste des hôtes que l’autorité est habilitée à authentifier. Si vide, l’autorité peut authentifier tous les hôtes.

  Status Codes:

    - 201 Created – L’autorité a été remplacée avec succès

    - 400 Bad Request – Un ou plusieurs des paramètres de l’autorité sont invalides

    - 401 Unauthorized – Authentification d’utilisateur invalide

    - 404 Not Found – L’autorité demandée n’existe pas

  En-têtes de réponse:

    - Location – Le chemin d’accès à l’autorité modifiée

  Exemple de requête

  >     PATCH https://my_waarp_transfer.net/api/authorities/tls_ca HTTP/1.1
  >     Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
  >     Content-Type: application/json
  >     Content-Length: 123

  >     {
  >       "name": "local_tls_ca",
  >       "validHosts": ["127.0.0.1"]
  >     }

  Exemple de réponse

  >     HTTP/1.1 201 CREATED
  >     Location: https://my_waarp_transfer.net/api/authorities/local_tls_ca