Löschen Sie eine Automatisierung mit OpenAPI

Löschen Sie eine Automatisierung aus dem Automation Hub, indem Sie den Endpunkt DELETE /api/v1/openapi/automations/{id} aufrufen.

Voraussetzungen

• Sie haben ein aktives Automation Hub API-Token. Anweisungen finden Sie unter Generieren Ihres Tokens aus Automation Hub.
• Sie kennen die numerische ID der Automatisierung, die Sie löschen möchten. Sie können sie über die URL der Automatisierung im Automation Hub oder über einen GET /api/v1/openapi/automations -Aufruf abrufen.
• Sie haben die Rolle „Systemadministrator“ oder „Programm-Manager“ .

Löschen einer Automatisierung

1. Erstellen Sie die Anforderungs-URL mithilfe der Automatisierungs-ID:

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

2. Fügen Sie den erforderlichen Authentifizierungsheader ein:

   Kopfzeile	Wert
   x-ah-openapi-app-key	Ihr Automation Hub API-Token
   x-ah-openapi-auth	openapi
   Content-Type	application/json

3. Fügen Sie optional einen Kommentar in den Anforderungstext ein:

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

4. Senden Sie die Anforderung.

Ergebnisse

Ein erfolgreicher Löschvorgang gibt HTTP 200 zurück. Die Automatisierung wird endgültig aus dem Mandanten entfernt und nicht mehr in Automation Hub angezeigt.

Fehlercodes

Code	Bedeutung
400	Ungültige Anforderung – Der Anforderungstext ist falsch formatiert, oder ein Pflichtfeld ist ungültig.
404	Nicht gefunden – im Mandanten ist keine Automatisierung mit der angegebenen ID vorhanden.

Beispiel: Löschen Sie mehrere Automatisierungen mithilfe eines Skripts

Verwenden Sie das folgende PowerShell-Skript, um eine Liste von Automatisierungen nach ID zu löschen:

$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)"
}

Weitere Informationen finden Sie auf der Seite API-Referenzen .