POST /_system/authentication-groups
Create a new authentication group
Create a new authentication group
| Key | Type | Example | Description |
|---|---|---|---|
| authorizationrequired | string | | Access token |
| Key | Type | Example | Description |
|---|---|---|---|
| descriptionoptional | string | | Group description |
| is_activeoptional | boolean | | Whether the group is active |
| nameoptional | string | | Group name |
| permissionsoptional | array | ["manage_users", ...] | Array of permission strings |
{
"_meta": {
"created": 1782166695,
"entity": 1,
"guid": "a23575f49d0af385314c1f02280163374297e018a692e5e4ab85eb307ebf6ebc",
"modified": 1782166695,
"updated": 1782166695
},
"description": "Full system access group",
"is_active": true,
"name": "Administrators",
"permissions": [
"view_audit_logs",
"manage_users",
"setting_edit_blueprints"
]
}{
"error": "INVALID_BODY",
"fields": [
"example"
]
}| Status | Error Code | Description |
|---|---|---|
400 | INVALID_BODY | Validation error |
401 | INVALID_ACCESS_TOKEN | Authentication required or invalid token |
| Permission | Description |
|---|---|
Bearer token | Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
authentication_groups_create | Required scope: authentication_groups_create |
Back to Authentication Groups Return to the Authentication Groups category to view other endpoints All API Categories Browse all available API categories