Organization User Group
OrganizationUserGroup
A logical group of users for simpler access control.
The group maps to internal users and external identities. It anchors bulk access assignment across projects and repositories.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be OrganizationUserGroup. |
| metadata | map | The engine reads the reserved keys name and organization to resolve the identity and the parent Organization. |
| spec | Spec | Desired user-group configuration. See Spec. |
Spec
Desired user-group configuration.
A description, an optional parent group, and the members.
| Property | Type | Description |
|---|---|---|
| description | string | Optional description of the group. The engine copies it to the description of the related GitHub team. |
| parent | string | Name of another OrganizationUserGroup manifest that is the parent of this group. This creates a nested hierarchy. The engine attaches the group under the resolved parent team. |
| members | Members | Internal and external members of the group. See Members. |
Members
Members of the group.
Internal OrganizationUser members and external email members.
| Property | Type | Description |
|---|---|---|
| users | list of string | Names of the OrganizationUser manifests that are members of the group. |
| external | list of string | Email addresses of members that no OrganizationUser manifest defines. The engine adds them as external members. |