---
endpoint: GET /schema/permission_groups
coverage: partial
unmeasured: a Manager person; on the probed site none has impersonation on. Blocked on the site
tags: [schema, permission, discovery]
scope: api
measured: site-wide; the script (probe 119), an Admin and an Artist (probe 132) and a Vendor (probe 162) via sudo
verdict: Lists the permission groups the caller may inspect: the script, an Artist and a Vendor see only their own, an Admin person every HumanUser group. In `/spec.json` since 2026-11-10, in no reference page.
---

# GET /schema/permission_groups

**Params**

| part | value |
|---|---|
| `permission_rule_set_entity_type` | optional, `HumanUser` or `ApiUser`. Defaults to the caller's own kind |

**Sample requests**

```python
r = c.get("/schema/permission_groups")
```

```json
{
  "data": [{"id": "<id>", "code": "api_admin", "display_name": "API Admin", "entity_type": "ApiUser",
            "parent_set_id": null, "updated_at": "<timestamp>"}],
  "links": {"self": "/api/v1/schema/permission_groups"}
}
```

```python
r = c.get("/schema/permission_groups", params={"permission_rule_set_entity_type": "HumanUser"})
```

```json
{"data": [], "links": {"self": "/api/v1/schema/permission_groups?permission_rule_set_entity_type=HumanUser"}}
```

**Response codes**

| status | when |
|---|---|
| 200 | always seen, with an empty `data` for a kind the caller may not inspect |

As a person, through `sudo_as_login` (probe 132), `?permission_rule_set_entity_type=HumanUser`:

| caller | groups listed |
|---|---|
| script, `api_admin` | none |
| Admin person | every HumanUser group; five on the probed site |
| Artist | `artist` only |
| Vendor | `vendor` only, with or without the parameter (probe 162) |

**Edge cases**

- `/spec.json` says a caller without `set_permissions` sees only its own group. The script, an API
  Admin, got its own group and an empty list for `HumanUser`.
- `code` is what the two child calls take in their path.

**Links**

- `endpoints/get_schema_permission_groups_code_entity_types_type`
- `endpoints/get_schema_permission_groups_code_entity_types_type_fields`
- `findings/119_field_absent_retired_live`
- `findings/027_auth_permissions`
