> ## 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.

# API Proxy Groups API

> The API Proxy Groups API provides endpoints for managing API Proxy Groups in Apinizer. API Proxy Groups allow you to group multiple API Proxies together and manage them as a single unit, including shared client routes, CORS settings, cache settings, and deployment.

## Endpoints

### CRUD Operations

* [List API Proxy Groups](/api-reference/api-proxy-groups/crud/list-api-proxy-groups) - Get all API Proxy Groups for a project
* [Create API Proxy Group](/api-reference/api-proxy-groups/crud/create-api-proxy-group) - Create a new API Proxy Group
* [Update API Proxy Group](/api-reference/api-proxy-groups/crud/update-api-proxy-group) - Update an existing API Proxy Group
* [Delete API Proxy Group](/api-reference/api-proxy-groups/crud/delete-api-proxy-group) - Delete an API Proxy Group

### API Proxy Management

* [Add API Proxy to Group](/api-reference/api-proxy-groups/api-proxies/add-api-proxy-to-group) - Add an API Proxy to a group
* [Remove API Proxy from Group](/api-reference/api-proxy-groups/api-proxies/remove-api-proxy-from-group) - Remove an API Proxy from a group

### Deployment

* [List Environments](/api-reference/api-proxy-groups/deployment/list-environments) - Get all environments of an API Proxy Group
* [Deploy API Proxy Group](/api-reference/api-proxy-groups/deployment/deploy-api-proxy-group) - Deploy an API Proxy Group to an environment
* [Undeploy API Proxy Group](/api-reference/api-proxy-groups/deployment/undeploy-api-proxy-group) - Undeploy an API Proxy Group from an environment

## Authentication

All endpoints require authentication using a Personal API Access Token.

## Permissions

### GET Operations (List API Proxy Groups, List Environments)

* User must have **`API_MANAGEMENT` + `VIEW`** permission in the project
* If the asset category does not exist, user must have **at least one permission** in the project

### POST/PUT/DELETE Operations (Create/Update/Delete API Proxy Group, Add/Remove API Proxies)

* User must have **`API_MANAGEMENT` + `MANAGE`** permission in the project
* For deployment operations, user must also have **`API_MANAGEMENT` + `DEPLOY_UNDEPLOY`** permission

### Permission Requirements

| Operation                                | Required Permission                                                     |
| ---------------------------------------- | ----------------------------------------------------------------------- |
| List API Proxy Groups, List Environments | `API_MANAGEMENT` + `VIEW` (or any permission if category doesn't exist) |
| Create/Update/Delete API Proxy Group     | `API_MANAGEMENT` + `MANAGE`                                             |
| Add/Remove API Proxy to/from Group       | `API_MANAGEMENT` + `MANAGE`                                             |
| Deploy/Undeploy API Proxy Group          | `API_MANAGEMENT` + `DEPLOY_UNDEPLOY`                                    |

## 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
* [API Proxies API](/api-reference/api-proxies/deployment/deploy-api-proxy.mdx) - API Proxy management