> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IP Groups API

> The IP Groups API provides endpoints for managing IP Groups in Apinizer. IP Groups allow you to group multiple IP addresses or CIDR ranges together for use in policies (e.g., Black IP, White IP policies).

## Overview

The IP Groups API provides endpoints for managing IP Groups in Apinizer. IP Groups allow you to group multiple IP addresses or CIDR ranges together for use in policies (e.g., Black IP, White IP policies).

## Endpoints

### CRUD Operations

* [Create IP Group](/api-reference/ip-groups/crud/create-ip-group) - Create a new IP Group
* [Update IP Group](/api-reference/ip-groups/crud/update-ip-group) - Update an existing IP Group
* [Delete IP Group](/api-reference/ip-groups/crud/delete-ip-group) - Delete an IP Group

### IP Management

* [Add IPs to Group](/api-reference/ip-groups/ips/add-ips-to-group) - Add IP addresses to an IP Group
* [Update IPs in Group](/api-reference/ip-groups/ips/update-ips-in-group) - Replace all IPs in an IP Group
* [Delete IPs from Group](/api-reference/ip-groups/ips/delete-ips-from-group) - Remove IP addresses from an IP Group

## Authentication

All endpoints require authentication using a Personal API Access Token.

## Permissions

### GET Operations (List IP Groups)

* User must have **any permission** in the project (read access)

### POST/PUT/DELETE Operations (Create/Update/Delete IP Group, Manage IPs)

* User must have **`GLOBAL_SETTINGS` + `MANAGE`** permission in the project

### Permission Requirements

| Operation                      | Required Permission          |
| ------------------------------ | ---------------------------- |
| List IP Groups                 | Any permission in project    |
| Create/Update/Delete IP Group  | `GLOBAL_SETTINGS` + `MANAGE` |
| Add/Update/Delete IPs in Group | `GLOBAL_SETTINGS` + `MANAGE` |

## Related Documentation

* [Authentication Guide](/api-reference/getting-started/authentication) - How to obtain and use API tokens
* [Error Handling](/api-reference/getting-started/error-handling) - Error response formats
* [Black IP Policy](/api-reference/policies/policies/policy-black-ip) - Use IP Groups in Black IP policy
* [White IP Policy](/api-reference/policies/policies/policy-white-ip) - Use IP Groups in White IP policy