1---
2layout: "api"
3page_title: "/sys/config/control-group - HTTP API"
4sidebar_title: "<code>/sys/config/control-group</code>"
5sidebar_current: "api-http-system-config-control-group"
6description: |-
7  The '/sys/config/control-group' endpoint configures control groups.
8---
9
10# `/sys/config/control-group`
11
12~> **Enterprise Only** – These endpoints require Vault Enterprise.
13
14The `/sys/config/control-group` endpoint is used to configure Control Group
15settings.
16
17## Read Control Group Settings
18
19This endpoint returns the current Control Group configuration.
20
21| Method   | Path                         |
22| :--------------------------- | :--------------------- |
23| `GET`    | `/sys/config/control-group` |
24
25### Sample Request
26
27```
28$ curl \
29    --header "X-Vault-Token: ..." \
30    http://127.0.0.1:8200/v1/sys/config/control-group
31```
32
33### Sample Response
34
35```json
36{
37  "max_ttl": "4h"
38}
39```
40
41## Configure Control Group Settings
42
43This endpoint allows configuring control groups.
44
45| Method   | Path                         |
46| :--------------------------- | :--------------------- |
47| `PUT`    | `/sys/config/control-group` |
48
49### Parameters
50
51- `max_ttl` `int` – The maximum ttl for a control group wrapping token.  This can be provided in seconds or duration (2h).
52
53### Sample Payload
54
55```json
56{
57  "max_ttl": "4h"
58}
59```
60
61### Sample Request
62
63```
64$ curl \
65    --header "X-Vault-Token: ..." \
66    --request PUT \
67    --data @payload.json \
68    http://127.0.0.1:8200/v1/sys/config/control-group
69```
70
71## Delete Control Group Settings
72
73This endpoint removes any control group configuration.
74
75| Method   | Path                         |
76| :--------------------------- | :--------------------- |
77| `DELETE` | `/sys/config/control-group` |
78
79### Sample Request
80
81```
82$ curl \
83    --header "X-Vault-Token: ..." \
84    --request DELETE \
85    http://127.0.0.1:8200/v1/sys/config/control-group
86```
87