> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/feature-management-experimentation/split-api-reference/groups.md).

# Groups

## List groups

> List all active groups in the account.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Groups"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/groups":{"get":{"summary":"List groups","description":"List all active groups in the account.","operationId":"list-groups","parameters":[{"name":"limit","in":"query","description":"1-200 are the potential values. Default=50.","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"401":{"description":"401","content":{"text/plain":{}}}},"deprecated":false,"tags":["Groups"]}}}}
```

## Create group

> Create a new group in your account.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Groups"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/groups":{"post":{"summary":"Create group","description":"Create a new group in your account.","operationId":"create-group","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"type":{"type":"string"}}}}}},"400":{"description":"400","content":{"text/plain":{}}},"401":{"description":"401","content":{"text/plain":{}}},"409":{"description":"409","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Groups"]}}}}
```

## Get group

> List all active groups in the account.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Groups"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/groups/{group_id}":{"get":{"summary":"Get group","description":"List all active groups in the account.","operationId":"get-group","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"type":{"type":"string"}}}}}},"401":{"description":"401","content":{"text/plain":{}}}},"deprecated":false,"tags":["Groups"],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string"}}]}}}}
```

## Update group

> List all active groups in the account.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Groups"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/groups/{group_id}":{"put":{"summary":"Update group","description":"List all active groups in the account.","operationId":"update-group","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"type":{"type":"string"}}}}}},"401":{"description":"401","content":{"text/plain":{}}}},"deprecated":false,"tags":["Groups"],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string"}}]}}}}
```

## Delete group

> Delete a group from your account.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Groups"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/groups/{group_id}":{"delete":{"summary":"Delete group","description":"Delete a group from your account.","operationId":"delete-group","responses":{"200":{"description":"200","content":{"application/json":{}}},"401":{"description":"401","content":{"text/plain":{}}}},"deprecated":false,"tags":["Groups"],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string"}}]}}}}
```
