---
title: Update an existing access group
canonical: https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/access-group/update-an-existing-access-group/
product: CloudConnexa Docs
---

# Update an existing access group

`PUT /api/v1/access-groups/{id}`

**Update existing access group.**

Sources/Destinations can be defined as specifically selected resource or all resources of some type(both existing and newly created)

For example:

```
"source": [
  {
    "type": "USER_GROUP",
    "allCovered": true
  }
],
"destination": [
  {
    "type": "NETWORK_SERVICE",
    "allCovered": true,
    "parent": "00000000-0000-0000-0000-000000000001",
  },
  {
    "type": "HOST_SERVICE",
    "allCovered": false,
    "parent": "00000000-0000-0000-0000-000000000002",
    "children": [
      "00000000-0000-0000-0000-000000000003"
    ]
  }
]
```

means all user groups will have access to:

- a network with id `00000000-0000-0000-0000-000000000001` (with all network’s applications and ip services)
- application/service with id `00000000-0000-0000-0000-000000000003` from host with id `00000000-0000-0000-0000-000000000002`

If new user group will be created later it will be automatically included into this access group source.

## Body parameter

```json
{
  "name": "string",
  "description": "string",
  "source": [
    {
      "type": "USER_GROUP",
      "allCovered": true,
      "parent": "00000000-0000-0000-0000-000000000000",
      "children": []
    }
  ],
  "destination": [
    {
      "type": "USER_GROUP",
      "allCovered": true,
      "parent": "00000000-0000-0000-0000-000000000000",
      "children": []
    }
  ]
}
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | true | Access group ID |
| body | body | [AccessGroupRequest](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/schemas/accessgrouprequest.md) | true | none |
| » name | body | string | false | none |
| » description | body | string | false | none |
| » source | body | \[[AccessItemSourceRequest](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/schemas/accessitemsourcerequest.md)\] | false | none |
| »» type | body | string | false | none |
| »» allCovered | body | boolean | false | none |
| »» parent | body | string | false | none |
| »» children | body | \[string\] | false | none |
| » destination | body | \[[AccessItemDestinationRequest](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/schemas/accessitemdestinationrequest.md)\] | false | none |
| »» type | body | string | false | none |
| »» allCovered | body | boolean | false | none |
| »» parent | body | string | false | none |
| »» children | body | \[string\] | false | none |

### Enumerated Values

| Parameter | Value |
| --- | --- |
| »» type | USER\_GROUP |
| »» type | NETWORK\_SERVICE |
| »» type | HOST |
| »» type | USER\_GROUP |
| »» type | NETWORK\_SERVICE |
| »» type | HOST\_SERVICE |
| »» type | PUBLISHED\_SERVICE |

## Responses

| Status | Meaning | Description | Schema |
| --- | --- | --- | --- |
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [AccessGroupResponse](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/schemas/accessgroupresponse.md) |

To perform this operation, you must be authenticated by means of one of the following methods: oauth

---

Prev: [Get access group](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/access-group/get-access-group.md)
Next: [Delete an existing access group](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/access-group/delete-an-existing-access-group.md)
Index: https://openvpn.net/cloud-docs/llms.txt