`POST /v1/orgs/{org}/groups`.
const url = 'https://api.updawg.net/v1/orgs/example/groups';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"description":"example","label_selector":"example","name":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.updawg.net/v1/orgs/example/groups \ --header 'Content-Type: application/json' \ --data '{ "description": "example", "label_selector": "example", "name": "example" }'Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Organization slug.
Request Bodyrequired
Section titled “Request Bodyrequired”object
Labels a host must all carry, with exactly these values. Absent for a purely static group. An empty map is refused: it would match every host.
Example generated
{ "description": "example", "label_selector": "example", "name": "example"}Responses
Section titled “Responses”Created.
object
grp_….
Every host it resolves to, static or by label, each counted once. Decommissioned hosts are in no group.
Hosts put in the group by hand. Decommissioned hosts are not counted.
Example generated
{ "created_at": "2026-04-15T12:00:00Z", "description": "example", "id": "example", "label_selector": "example", "name": "example", "resolved_hosts": 1, "static_hosts": 1}No name, or a selector that is empty or has an empty key.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}No session.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}Not permitted for this role.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}No such organization, or not yours — one answer for both.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}A group with that name exists.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}The organization’s data is in another region (wrong-region, DAWG-159). detail names that region’s API; send the request there.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}Over the organization’s request limit. Retry-After says when to try again; RateLimit-Limit is the burst.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}