Groups & Config Profiles

These endpoints are organization-scoped under /orgs/:orgId.

Device groups

Method	Path	Description
GET	/orgs/:orgId/groups	List groups with their effective device count
POST	/orgs/:orgId/groups	Create a group
DELETE	/orgs/:orgId/groups/:id	Delete a group
GET	/orgs/:orgId/groups/:id/devices	List effective members (explicit + smart-tag)
POST	/orgs/:orgId/groups/:id/members	Add explicit members
DELETE	/orgs/:orgId/groups/:id/members/:deviceId	Remove an explicit member
POST	/orgs/:orgId/groups/:id/jobs	Dispatch a job to every member

Create a group

POST /orgs/:orgId/groups
Content-Type: application/json

{
  "name": "Site Alpha routers",
  "smartTags": ["site-alpha"]
}

smartTags is optional; devices whose tags match are included automatically (subject to plan).

Dispatch a job to a group

POST /orgs/:orgId/groups/:id/jobs
Content-Type: application/json

{
  "kind": "apply_config"
}

Supported kind values include reboot, apply_config, and firmware_update. Each member device gets its own job; track them through the Jobs endpoints.

Config profiles

Method	Path	Description
GET	/orgs/:orgId/configs	List config profiles
POST	/orgs/:orgId/configs	Create a config profile
PATCH	/orgs/:orgId/configs/:id	Update a config profile
DELETE	/orgs/:orgId/configs/:id	Delete a config profile
POST	/orgs/:orgId/configs/:profileId/apply	Apply a profile to devices or a group

Apply a profile

POST /orgs/:orgId/configs/:profileId/apply
Content-Type: application/json

{
  "deviceIds": ["<uuid>", "<uuid>"]
}

Apply to a list of devices, or target a group. The response references the resulting jobs so you can follow each device to success or failure. Secret values in profiles are redacted when listed back.