Delete automation rule

Deletes one automation rule by rule_id for the authenticated tenant. Authentication uses x-api-key with optional x-tenant-id; RBAC requires automation:delete. The service blocks deletion when pending/running executions exist, unschedules active rules, deletes automation_rules row, and emits automation.rule.deleted + audit log events. Missing rules and delete constraints currently bubble as 500 errors.

RBAC · automation

Path parameters

idstring <uuid>Required

Automation rule UUID from automation_rules.rule_id.

Response codes

204

Automation rule deleted successfully.

400

Invalid rule UUID format.

401

API key is missing, invalid, expired, over limit, or the key user was not found.

403

Authenticated user lacks automation:delete permission.

404

Intended not-found response for missing rules; current service may surface this as 500.

500

Unexpected failure, including running-execution constraints and generic not-found errors.

DELETE /api/v1/automation/rules/{id}

cURL

curl -X DELETE "https://algapsa.com/api/v1/automation/rules/{id}" \
  -H "X-API-Key: $ALGA_API_KEY"

TypeScript

const response = await fetch("https://algapsa.com/api/v1/automation/rules/{id}", {
  method: "DELETE",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Delete, "https://algapsa.com/api/v1/automation/rules/{id}");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();