# Update outlet client group.

`PUT /api/v1/Outlets/{outletId}/ClientGroups/{id}`

Core API · OutletClientGroups · base URL `https://core-api.ancon.io` · auth: `Access-Token` header · docs: https://ancon.dev/api/core/outlet-client-groups/update-outlet-client-group

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `outletId` | string (uuid) | yes |  |
| `id` | string (uuid) | yes |  |

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `correlationId` | string | no | Correlation Id for the request |

## Request body

Content type: `application/json`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | yes | Name of outlet client group |
| `costCenter` | string | yes | CostCenter of outlet client group |
| `project` | string or null | no | Project of outlet client group |
| `clientIds` | array<string (uuid)> or null | no | Ids of outlet clients |
| `custom1` | string or null | no |  |
| `custom2` | string or null | no |  |
| `custom3` | string or null | no |  |
| `custom4` | string or null | no |  |
| `custom5` | string or null | no |  |

### Outlet client group example 1

```json
{
  "name": "POS group 1",
  "costCenter": "9661",
  "project": "2665",
  "clientIds": [
    "23206068-582e-4b48-9b30-579b4a584c15",
    "65f488b8-fbc6-48d0-842a-e4a4a758cb14"
  ],
  "custom1": null,
  "custom2": null,
  "custom3": null,
  "custom4": null,
  "custom5": null
}
```

### Outlet client group example 2

```json
{
  "name": "POS group 2 - updated",
  "costCenter": "6658",
  "project": "7856",
  "clientIds": [
    "7a9a7e01-c29f-47ae-a050-495cb8803c5d"
  ],
  "custom1": null,
  "custom2": null,
  "custom3": null,
  "custom4": null,
  "custom5": null
}
```

## Responses

| Status | Description |
| --- | --- |
| 200 | OK |
| 401 | Unauthorized |
| 404 | Not Found |

### 200 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `clientGroup` | object or null | no |  |
| `clientGroup.id` | string (uuid) | no |  |
| `clientGroup.created` | string (date-time) | no |  |
| `clientGroup.modified` | string (date-time) | no |  |
| `clientGroup.outletId` | string (uuid) | no |  |
| `clientGroup.name` | string or null | no |  |
| `clientGroup.costCenter` | string or null | no |  |
| `clientGroup.project` | string or null | no |  |
| `clientGroup.clients` | array<object> or null | no |  |
| `clientGroup.clients[].id` | string (uuid) | no |  |
| `clientGroup.clients[].name` | string or null | no |  |
| `clientGroup.clients[].clientType` | integer (int32) | no | Allowed values: `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`. |
| `clientGroup.custom1` | string or null | no |  |
| `clientGroup.custom2` | string or null | no |  |
| `clientGroup.custom3` | string or null | no |  |
| `clientGroup.custom4` | string or null | no |  |
| `clientGroup.custom5` | string or null | no |  |

#### Outlet client group example 1

```json
{
  "clientGroup": {
    "id": "6c09cec9-ab3e-45f2-a932-fa802d26adae",
    "created": "2026-10-23T14:33:34.1521167Z",
    "modified": "2026-10-23T14:33:34.1521171Z",
    "outletId": "2d02e1b8-5a68-42dd-9918-9ac732e665d5",
    "name": "POS Group",
    "costCenter": "9668",
    "project": "2665",
    "clients": [
      {
        "id": "86700a38-a47b-4df7-85ef-eb5fa396bcd5",
        "name": "POS Licence 1",
        "clientType": 0
      },
      {
        "id": "ea85c4aa-167f-4d4a-9f49-cbf16a307e7d",
        "name": "POS Licence 2",
        "clientType": 0
      }
    ],
    "custom1": null,
    "custom2": null,
    "custom3": null,
    "custom4": null,
    "custom5": null
  }
}
```

### 401 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `message` | string or null | no |  |

#### Example (from schema)

```json
{
  "message": "string"
}
```

### 404 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `message` | string or null | no |  |
| `errorCode` | string (uuid) | no |  |

#### Example (from schema)

```json
{
  "message": "string",
  "errorCode": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
```

## Example request

```bash
curl -X PUT "https://core-api.ancon.io/api/v1/Outlets/{outletId}/ClientGroups/{id}" \
  -H "Access-Token: $ANCON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "POS group 1",
  "costCenter": "9661",
  "project": "2665",
  "clientIds": [
    "23206068-582e-4b48-9b30-579b4a584c15",
    "65f488b8-fbc6-48d0-842a-e4a4a758cb14"
  ],
  "custom1": null,
  "custom2": null,
  "custom3": null,
  "custom4": null,
  "custom5": null
}'
```