Bulk-delete agents

Starts an asynchronous job that deletes up to 100 agents. Set `force=true` to delete execution history for every target, matching the single-agent delete endpoint; `force` must be a JSON boolean, and the strings `"true"` and `"false"` are rejected with 422 rather than coerced. A target with execution history and `force=false` fails with `execution_history_exists`. If the job itself fails, the target it stopped on carries `delete_failed` and every target behind it carries `not_attempted`, which means it was left untouched and is safe to resubmit. Authorization is captured when the request is accepted, not when the job runs: a role or organization granted after acceptance does not widen what the job may delete.

Authentication

X-API-Keystring
Enter your API key for programmatic access
OR
AuthorizationBearer

Enter your JWT token (without the β€˜Bearer ’ prefix)

Request

Bulk agent deletion request
idslist of stringsRequired
Unique target IDs in the order results must be returned.
forcebooleanOptionalDefaults to false
Delete execution history before deleting each agent.

Response headers

LocationstringOptional

Owner-scoped polling URL for the accepted bulk-deletion job.

Response

Bulk deletion accepted
dataobject

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
503
Service Unavailable Error