> For the complete documentation index, see [llms.txt](https://docs.xibosignage.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xibosignage.com/developer/integrate/openapi/usergroup.md).

# Usergroup

User Groups

## UserGroup Search

> Search User Groups

```json
{"openapi":"3.1.1","info":{"title":"Xibo API","version":"4.0"},"tags":[{"name":"usergroup","description":"User Groups"}],"servers":[{"url":"/api"}],"security":[{"auth":["write:all","read:all"]}],"components":{"securitySchemes":{"auth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/api/authorize","tokenUrl":"/api/authorize/access_token","scopes":{"read:all":"read access","write:all":"write access"}}}}},"schemas":{"UserGroup":{"properties":{"groupId":{"description":"The Group ID","type":"integer"},"group":{"description":"The group name","type":"string"},"isUserSpecific":{"description":"A flag indicating whether this is a user specific group or not","type":"integer"},"isEveryone":{"description":"A flag indicating the special everyone group","type":"integer"},"description":{"description":"Description of this User Group","type":"string"},"libraryQuota":{"description":"This users library quota in bytes. 0 = unlimited","type":"integer"},"isSystemNotification":{"description":"Does this Group receive system notifications.","type":"integer"},"isDisplayNotification":{"description":"Does this Group receive display notifications.","type":"integer"},"isDataSetNotification":{"description":"Does this Group receive DataSet notifications.","type":"integer"},"isLayoutNotification":{"description":"Does this Group receive Layout notifications.","type":"integer"},"isLibraryNotification":{"description":"Does this Group receive Library notifications.","type":"integer"},"isReportNotification":{"description":"Does this Group receive Report notifications.","type":"integer"},"isScheduleNotification":{"description":"Does this Group receive Schedule notifications.","type":"integer"},"isCustomNotification":{"description":"Does this Group receive Custom notifications.","type":"integer"},"isShownForAddUser":{"description":"Is this Group shown in the list of choices when onboarding a new user","type":"integer"},"defaultHomepageId":{"description":"Default Home page for new users","type":"string"},"features":{"description":"Features this User Group has direct access to","type":"array","items":{"type":"string"}}}}}},"paths":{"/group":{"get":{"tags":["usergroup"],"summary":"UserGroup Search","description":"Search User Groups","operationId":"userGroupSearch","parameters":[{"schema":{"type":"integer"},"name":"userGroupId","in":"query","description":"Filter by UserGroup Id","required":false},{"schema":{"type":"string"},"name":"userGroup","in":"query","description":"Filter by UserGroup Name","required":false}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserGroup"}}}}}}}}}}
```

## UserGroup Add

> Add User Group

```json
{"openapi":"3.1.1","info":{"title":"Xibo API","version":"4.0"},"tags":[{"name":"usergroup","description":"User Groups"}],"servers":[{"url":"/api"}],"security":[{"auth":["write:all","read:all"]}],"components":{"securitySchemes":{"auth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/api/authorize","tokenUrl":"/api/authorize/access_token","scopes":{"read:all":"read access","write:all":"write access"}}}}},"schemas":{"UserGroup":{"properties":{"groupId":{"description":"The Group ID","type":"integer"},"group":{"description":"The group name","type":"string"},"isUserSpecific":{"description":"A flag indicating whether this is a user specific group or not","type":"integer"},"isEveryone":{"description":"A flag indicating the special everyone group","type":"integer"},"description":{"description":"Description of this User Group","type":"string"},"libraryQuota":{"description":"This users library quota in bytes. 0 = unlimited","type":"integer"},"isSystemNotification":{"description":"Does this Group receive system notifications.","type":"integer"},"isDisplayNotification":{"description":"Does this Group receive display notifications.","type":"integer"},"isDataSetNotification":{"description":"Does this Group receive DataSet notifications.","type":"integer"},"isLayoutNotification":{"description":"Does this Group receive Layout notifications.","type":"integer"},"isLibraryNotification":{"description":"Does this Group receive Library notifications.","type":"integer"},"isReportNotification":{"description":"Does this Group receive Report notifications.","type":"integer"},"isScheduleNotification":{"description":"Does this Group receive Schedule notifications.","type":"integer"},"isCustomNotification":{"description":"Does this Group receive Custom notifications.","type":"integer"},"isShownForAddUser":{"description":"Is this Group shown in the list of choices when onboarding a new user","type":"integer"},"defaultHomepageId":{"description":"Default Home page for new users","type":"string"},"features":{"description":"Features this User Group has direct access to","type":"array","items":{"type":"string"}}}}}},"paths":{"/group":{"post":{"tags":["usergroup"],"summary":"UserGroup Add","description":"Add User Group","operationId":"userGroupAdd","responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserGroup"}}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"group":{"type":"string","description":"Name of the User Group"},"decription":{"type":"string","description":"A description of the User Group"},"libraryQuota":{"type":"string","description":"The quota that should be applied (KiB). Provide 0 for no quota"},"isSystemNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive system notifications?"},"isDisplayNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Display notifications\r\n     * for Displays they have permissions to see"},"isDataSetNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive DataSet notification emails?"},"isLayoutNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Layout notification emails?"},"isLibraryNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Library notification emails?"},"isReportNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Report notification emails?"},"isScheduleNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Schedule notification emails?"},"isCustomNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Custom notification emails?"},"isShownForAddUser":{"type":"integer","description":"Flag (0, 1), should this Group be shown in the Add User onboarding form."},"defaultHomePageId":{"type":"integer","description":"If this user has been created via the onboarding form, this should be the default home page"}},"required":["group"]}}}}}}}}
```

## UserGroup Edit

> Edit User Group

```json
{"openapi":"3.1.1","info":{"title":"Xibo API","version":"4.0"},"tags":[{"name":"usergroup","description":"User Groups"}],"servers":[{"url":"/api"}],"security":[{"auth":["write:all","read:all"]}],"components":{"securitySchemes":{"auth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/api/authorize","tokenUrl":"/api/authorize/access_token","scopes":{"read:all":"read access","write:all":"write access"}}}}},"schemas":{"UserGroup":{"properties":{"groupId":{"description":"The Group ID","type":"integer"},"group":{"description":"The group name","type":"string"},"isUserSpecific":{"description":"A flag indicating whether this is a user specific group or not","type":"integer"},"isEveryone":{"description":"A flag indicating the special everyone group","type":"integer"},"description":{"description":"Description of this User Group","type":"string"},"libraryQuota":{"description":"This users library quota in bytes. 0 = unlimited","type":"integer"},"isSystemNotification":{"description":"Does this Group receive system notifications.","type":"integer"},"isDisplayNotification":{"description":"Does this Group receive display notifications.","type":"integer"},"isDataSetNotification":{"description":"Does this Group receive DataSet notifications.","type":"integer"},"isLayoutNotification":{"description":"Does this Group receive Layout notifications.","type":"integer"},"isLibraryNotification":{"description":"Does this Group receive Library notifications.","type":"integer"},"isReportNotification":{"description":"Does this Group receive Report notifications.","type":"integer"},"isScheduleNotification":{"description":"Does this Group receive Schedule notifications.","type":"integer"},"isCustomNotification":{"description":"Does this Group receive Custom notifications.","type":"integer"},"isShownForAddUser":{"description":"Is this Group shown in the list of choices when onboarding a new user","type":"integer"},"defaultHomepageId":{"description":"Default Home page for new users","type":"string"},"features":{"description":"Features this User Group has direct access to","type":"array","items":{"type":"string"}}}}}},"paths":{"/group/{userGroupId}":{"put":{"tags":["usergroup"],"summary":"UserGroup Edit","description":"Edit User Group","operationId":"userGroupEdit","parameters":[{"schema":{"type":"integer"},"name":"userGroupId","in":"path","description":"ID of the User Group","required":true}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserGroup"}}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"group":{"type":"string","description":"Name of the User Group"},"decription":{"type":"string","description":"A description of the User Group"},"libraryQuota":{"type":"string","description":"The quota that should be applied (KiB). Provide 0 for no quota"},"isSystemNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive system notifications?"},"isDisplayNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Display notifications\r\n     * for Displays they have permissions to see"},"isDataSetNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive DataSet notification emails?"},"isLayoutNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Layout notification emails?"},"isLibraryNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Library notification emails?"},"isReportNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Report notification emails?"},"isScheduleNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Schedule notification emails?"},"isCustomNotification":{"type":"integer","description":"Flag (0, 1), should members of this Group receive Custom notification emails?"},"isShownForAddUser":{"type":"integer","description":"Flag (0, 1), should this Group be shown in the Add User onboarding form."},"defaultHomePageId":{"type":"integer","description":"If this user has been created via the onboarding form, this should be the default home page"}},"required":["group"]}}}}}}}}
```

## Delete User Group

> Delete User Group

```json
{"openapi":"3.1.1","info":{"title":"Xibo API","version":"4.0"},"tags":[{"name":"usergroup","description":"User Groups"}],"servers":[{"url":"/api"}],"security":[{"auth":["write:all","read:all"]}],"components":{"securitySchemes":{"auth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/api/authorize","tokenUrl":"/api/authorize/access_token","scopes":{"read:all":"read access","write:all":"write access"}}}}}},"paths":{"/group/{userGroupId}":{"delete":{"tags":["usergroup"],"summary":"Delete User Group","description":"Delete User Group","operationId":"userGroupDelete","parameters":[{"schema":{"type":"integer"},"name":"userGroupId","in":"path","description":"The user Group ID to Delete","required":true}],"responses":{"204":{"description":"successful operation"}}}}}}
```

## Assign User to User Group

> Assign User to User Group

```json
{"openapi":"3.1.1","info":{"title":"Xibo API","version":"4.0"},"tags":[{"name":"usergroup","description":"User Groups"}],"servers":[{"url":"/api"}],"security":[{"auth":["write:all","read:all"]}],"components":{"securitySchemes":{"auth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/api/authorize","tokenUrl":"/api/authorize/access_token","scopes":{"read:all":"read access","write:all":"write access"}}}}},"schemas":{"UserGroup":{"properties":{"groupId":{"description":"The Group ID","type":"integer"},"group":{"description":"The group name","type":"string"},"isUserSpecific":{"description":"A flag indicating whether this is a user specific group or not","type":"integer"},"isEveryone":{"description":"A flag indicating the special everyone group","type":"integer"},"description":{"description":"Description of this User Group","type":"string"},"libraryQuota":{"description":"This users library quota in bytes. 0 = unlimited","type":"integer"},"isSystemNotification":{"description":"Does this Group receive system notifications.","type":"integer"},"isDisplayNotification":{"description":"Does this Group receive display notifications.","type":"integer"},"isDataSetNotification":{"description":"Does this Group receive DataSet notifications.","type":"integer"},"isLayoutNotification":{"description":"Does this Group receive Layout notifications.","type":"integer"},"isLibraryNotification":{"description":"Does this Group receive Library notifications.","type":"integer"},"isReportNotification":{"description":"Does this Group receive Report notifications.","type":"integer"},"isScheduleNotification":{"description":"Does this Group receive Schedule notifications.","type":"integer"},"isCustomNotification":{"description":"Does this Group receive Custom notifications.","type":"integer"},"isShownForAddUser":{"description":"Is this Group shown in the list of choices when onboarding a new user","type":"integer"},"defaultHomepageId":{"description":"Default Home page for new users","type":"string"},"features":{"description":"Features this User Group has direct access to","type":"array","items":{"type":"string"}}}}}},"paths":{"/group/members/assign/{userGroupId}":{"post":{"tags":["usergroup"],"summary":"Assign User to User Group","description":"Assign User to User Group","operationId":"userGroupAssign","parameters":[{"schema":{"type":"integer"},"name":"userGroupId","in":"path","description":"ID of the user group to which assign the user","required":true}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserGroup"}}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"userId":{"type":"array","description":"Array of userIDs to assign"}},"required":["userId"]}}}}}}}}
```

## Unassign User from User Group

> Unassign User from User Group

```json
{"openapi":"3.1.1","info":{"title":"Xibo API","version":"4.0"},"tags":[{"name":"usergroup","description":"User Groups"}],"servers":[{"url":"/api"}],"security":[{"auth":["write:all","read:all"]}],"components":{"securitySchemes":{"auth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/api/authorize","tokenUrl":"/api/authorize/access_token","scopes":{"read:all":"read access","write:all":"write access"}}}}},"schemas":{"UserGroup":{"properties":{"groupId":{"description":"The Group ID","type":"integer"},"group":{"description":"The group name","type":"string"},"isUserSpecific":{"description":"A flag indicating whether this is a user specific group or not","type":"integer"},"isEveryone":{"description":"A flag indicating the special everyone group","type":"integer"},"description":{"description":"Description of this User Group","type":"string"},"libraryQuota":{"description":"This users library quota in bytes. 0 = unlimited","type":"integer"},"isSystemNotification":{"description":"Does this Group receive system notifications.","type":"integer"},"isDisplayNotification":{"description":"Does this Group receive display notifications.","type":"integer"},"isDataSetNotification":{"description":"Does this Group receive DataSet notifications.","type":"integer"},"isLayoutNotification":{"description":"Does this Group receive Layout notifications.","type":"integer"},"isLibraryNotification":{"description":"Does this Group receive Library notifications.","type":"integer"},"isReportNotification":{"description":"Does this Group receive Report notifications.","type":"integer"},"isScheduleNotification":{"description":"Does this Group receive Schedule notifications.","type":"integer"},"isCustomNotification":{"description":"Does this Group receive Custom notifications.","type":"integer"},"isShownForAddUser":{"description":"Is this Group shown in the list of choices when onboarding a new user","type":"integer"},"defaultHomepageId":{"description":"Default Home page for new users","type":"string"},"features":{"description":"Features this User Group has direct access to","type":"array","items":{"type":"string"}}}}}},"paths":{"/group/members/unassign/{userGroupId}":{"post":{"tags":["usergroup"],"summary":"Unassign User from User Group","description":"Unassign User from User Group","operationId":"userGroupUnassign","parameters":[{"schema":{"type":"integer"},"name":"userGroupId","in":"path","description":"ID of the user group from which to unassign the user","required":true}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserGroup"}}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"userId":{"type":"array","description":"Array of userIDs to unassign"}},"required":["userId"]}}}}}}}}
```

## Copy User Group

> Copy an user group, optionally copying the group members

```json
{"openapi":"3.1.1","info":{"title":"Xibo API","version":"4.0"},"tags":[{"name":"usergroup","description":"User Groups"}],"servers":[{"url":"/api"}],"security":[{"auth":["write:all","read:all"]}],"components":{"securitySchemes":{"auth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/api/authorize","tokenUrl":"/api/authorize/access_token","scopes":{"read:all":"read access","write:all":"write access"}}}}},"schemas":{"UserGroup":{"properties":{"groupId":{"description":"The Group ID","type":"integer"},"group":{"description":"The group name","type":"string"},"isUserSpecific":{"description":"A flag indicating whether this is a user specific group or not","type":"integer"},"isEveryone":{"description":"A flag indicating the special everyone group","type":"integer"},"description":{"description":"Description of this User Group","type":"string"},"libraryQuota":{"description":"This users library quota in bytes. 0 = unlimited","type":"integer"},"isSystemNotification":{"description":"Does this Group receive system notifications.","type":"integer"},"isDisplayNotification":{"description":"Does this Group receive display notifications.","type":"integer"},"isDataSetNotification":{"description":"Does this Group receive DataSet notifications.","type":"integer"},"isLayoutNotification":{"description":"Does this Group receive Layout notifications.","type":"integer"},"isLibraryNotification":{"description":"Does this Group receive Library notifications.","type":"integer"},"isReportNotification":{"description":"Does this Group receive Report notifications.","type":"integer"},"isScheduleNotification":{"description":"Does this Group receive Schedule notifications.","type":"integer"},"isCustomNotification":{"description":"Does this Group receive Custom notifications.","type":"integer"},"isShownForAddUser":{"description":"Is this Group shown in the list of choices when onboarding a new user","type":"integer"},"defaultHomepageId":{"description":"Default Home page for new users","type":"string"},"features":{"description":"Features this User Group has direct access to","type":"array","items":{"type":"string"}}}}}},"paths":{"/group/{userGroupId}/copy":{"post":{"tags":["usergroup"],"summary":"Copy User Group","description":"Copy an user group, optionally copying the group members","operationId":"userGroupCopy","parameters":[{"schema":{"type":"integer"},"name":"userGroupId","in":"path","description":"The User Group ID to Copy","required":true}],"responses":{"201":{"description":"successful operation","headers":{"Location":{"description":"Location of the new record","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserGroup"}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"group":{"type":"string","description":"The Group Name"},"copyMembers":{"type":"integer","description":"Flag indicating whether to copy group members"},"copyFeatures":{"type":"integer","description":"Flag indicating whether to copy group features"}},"required":["group"]}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.xibosignage.com/developer/integrate/openapi/usergroup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.