Supprimer une automatisation à l'aide d'OpenAPI

Supprimez une automatisation d'Automation Hub en appelant le point de terminaison DELETE /api/v1/openapi/automations/{id} .

Prérequis

• Vous avez un jeton d’API Automation Hub actif. Pour obtenir des instructions, consultez Générer votre jeton depuis Automation Hub.
• Vous connaissez l'ID numérique de l'automatisation que vous souhaitez supprimer. Vous pouvez le récupérer à partir de l'URL de l'automatisation dans Automation Hub ou via un appel GET /api/v1/openapi/automations .
• Vous avez le rôle d'Administrateur système ou de Gestionnaire de programme .

Supprimer une automatisation

1. Créez l'URL de la demande à l'aide de l'ID de l'automatisation:

   DELETE https://{baseUrl}/api/v1/openapi/automations/{id}
   

2. Incluez l'en-tête d'authentification requis:

   En-tête	Valeur (Value)
   x-ah-openapi-app-key	Votre jeton d’API Automation Hub
   x-ah-openapi-auth	openapi
   Content-Type	application/json

3. Incluez éventuellement un commentaire dans le corps de la requête:

   {
     "comment": "Removing duplicate entry."
   }
   

4. Envoyez la demande.

Résultats

Une suppression réussie renvoie HTTP 200. L'automatisation est supprimée définitivement du locataire et n'apparaît plus dans Automation Hub.

Codes d’erreur

Code	Signification
400	Requête incorrecte: le corps de la requête est incorrect ou un champ requis n’est pas valide.
404	Introuvable: aucune automatisation avec l’ID spécifié n’existe dans le locataire.

Exemple: supprimer plusieurs automatisations à l'aide d'un script

Utilisez le script PowerShell suivant pour supprimer une liste d'automatisations par ID:

$baseUrl  = "https://<your-tenant>.automation-hub.uipath.com"
$appKey   = "<your-api-token>"
$ids      = @(1001, 1002, 1003)
$comment  = "Bulk cleanup"

foreach ($id in $ids) {
    $response = Invoke-RestMethod `
        -Method Delete `
        -Uri "$baseUrl/api/v1/openapi/automations/$id" `
        -Headers @{
            "x-ah-openapi-app-key" = $appKey
            "x-ah-openapi-auth"    = "openapi"
            "Content-Type"         = "application/json"
        } `
        -Body (ConvertTo-Json @{ comment = $comment })
    Write-Host "Deleted $id — Status: $($response.StatusCode)"
}

Pour plus d'informations, consultez la page Références d'API .