---
title: "Bulk Enable Agents"
method: POST
path: "/agents/bulk/enable"
tags: ["agents"]
---

# Bulk Enable Agents

`POST /agents/bulk/enable`

## Request

- Base URL: `https://api.instruxi.dev/api/v1/enforcer`
- URL: `https://api.instruxi.dev/api/v1/enforcer/agents/bulk/enable`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

Enables many agents; a suspended agent whose cause still holds is skipped with agent_suspended. Exactly one of ids or filter; at most 500.

## Request body

- InternalDeliveryHttpHandlerBulkAgentsRequest
  - `filter` InternalDeliveryHttpHandlerBulkAgentFilter
    - `owner` string: Owner is account:<id> or group:<id>.
    - `state` 'active' | 'disabled' | 'suspended'
  - `ids` string[]
  - `reason` string

## Response `200`

OK

- InternalDeliveryHttpHandlerBulkAgentsResponse
  - `data` InternalDeliveryHttpHandlerBulkAgentsData
    - `disabled` integer
    - `enabled` integer
    - `skipped` InternalDeliveryHttpHandlerBulkAgentsSkip[]
      - `error` string
      - `id` string
  - `success` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/instruxi/apis/enforcer-api.md) · [All operations](https://skmtc.dev/instruxi/apis/enforcer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instruxi/apis/enforcer-api/revisions/fa82bc1becc0?raw)