---
title: "PUT /hostgroups/{hostgroupname}/"
method: PUT
path: "/v1/hostgroups/{hostgroupname}/"
---

# PUT /hostgroups/{hostgroupname}/

`PUT /v1/hostgroups/{hostgroupname}/`

Set info for a host group

## Path parameters

- `hostgroupname` string, required

## Request body

- object
  - `all_users` boolean — Allow all users access regardless of hostgroup membership status
  - `rules` object[]
    - `field` string, required — The property of the host to check, e.x. "hostname"
    - `type` string, required — The type of rule to evaluate, e.x. "regex"
    - `negated` boolean — Whether or not the rule type is negated, e.x. "starts with" would become "does not start with"
    - `value` string, required — The string value to run the check against
  - `operator` string — The logical operator used to check the rules. Must be "OR" or "AND".

## Response `200`

200

- object
  - `status` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/foxpass/apis/api-instructions.md) · [All operations](https://skmtc.net/foxpass/apis/api-instructions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/foxpass/api-instructions/versions/d0d15848629a/schema)