删除使用 OpenAPI 的自动化

通过调用DELETE /api/v1/openapi/automations/{id}端点从 Automation Hub 中删除自动化。

先决条件

• 您拥有有效的 Automation Hub API 令牌。有关说明，请参阅从 Automation Hub 生成令牌。
• 您知道要删除的自动化的数字 ID。您可以从 Automation Hub 中的自动化 URL 或通过GET /api/v1/openapi/automations调用进行检索。
• 您具有系统管理员或程序经理角色。

删除自动化

1. 使用自动化 ID 构建请求 URL：

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

2. 包含所需的身份验证标头：

   页眉	值
   x-ah-openapi-app-key	您的 Automation Hub API 令牌
   x-ah-openapi-auth	openapi
   Content-Type	application/json

3. 可以选择在请求正文中包含注释：

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

4. 发送请求。

结果

成功删除将返回 HTTP 200 。自动化已从租户中永久删除，并且不再显示在 Automation Hub 中。

错误代码

代码	意义
400	请求错误 — 请求正文格式错误或必填字段无效。
404	未找到 — 租户中不存在具有指定 ID 的自动化。

示例：使用脚本删除多个自动化

使用以下 PowerShell 脚本按 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)"
}

有关更多信息，请参阅API 参考页面。