Eliminar una automatización utilizando OpenAPI

Elimina una automatización de Automation Hub llamando al punto final DELETE /api/v1/openapi/automations/{id} .

Requisitos previos

• Tienes un token de API de Automation Hub activo. Para obtener instrucciones, consulta Generar tu token desde Automation Hub.
• Conoces el ID numérico de la automatización que quieres eliminar. Puedes recuperarlo desde la URL de la automatización en Automation Hub o a través de una llamada GET /api/v1/openapi/automations .
• Tienes el rol de Administrador del sistema o Gestor del programa .

Eliminar una automatización

1. Construye la URL de la solicitud utilizando el ID de automatización:

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

2. Incluye el encabezado de autenticación requerido:

   Encabezado	Valor
   x-ah-openapi-app-key	Su token de API de Automation Hub
   x-ah-openapi-auth	openapi
   Content-Type	application/json

3. Opcionalmente, incluye un comentario en el cuerpo de la solicitud:

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

4. Envía la solicitud.

Resultados

Una eliminación correcta devuelve HTTP 200. La automatización se elimina de forma permanente del tenant y ya no aparece en Automation Hub.

Códigos de error

Código	Significado
400	Solicitud incorrecta: el cuerpo de la solicitud tiene un formato incorrecto o un campo obligatorio no es válido.
404	No encontrado: no existe ninguna automatización con el ID especificado en el tenant.

Ejemplo: eliminar varias automatizaciones utilizando un script

Utiliza el siguiente script de PowerShell para eliminar una lista de automatizaciones por 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)"
}

Para obtener más información, consulta la página Referencias de la API .