GroupsApi
Method | HTTP request | Description |
---|---|---|
create_group_using_post | POST /api/web/v1/groups | Create a group |
delete_group_using_delete | DELETE /api/web/v1/groups/{id} | Remove a group |
group_by_external_id_using_post | POST /api/web/v1/groups/externalid | Get a group by externalId |
group_using_get | GET /api/web/v1/groups/{id} | Get a group |
groups_paged_using_post | POST /api/web/v1/groupspaged | List a page of groups |
groups_using_get | GET /api/web/v1/groups | List groups |
modify_user_authorization_group_associations_using_put | PUT /api/web/v1/userauthorizationgroup/{userid}/groups | Modify user group membership |
update_group_using_put | PUT /api/web/v1/groups/{id} | Update a group |
create_group_using_post
Group create_group_using_post(group_parms)
Create a group
Create a group with the specified name. Caller requires the GROUPS:ADD permission.
- Api Key Authentication (AdminAPIAuthentication):
Parameters
Name | Type | Description | Notes |
---|---|---|---|
group_parms | GroupParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
Status code | Description | Response headers |
---|---|---|
200 | Successful | - |
400 | Bad Request | - |
401 | Access denied | - |
403 | Forbidden | - |
404 | Not Found | - |
409 | Conflict | - |
delete_group_using_delete
delete_group_using_delete(id)
Remove a group
Remove the specified group. Caller requires the GROUPS:REMOVE permission.
Example
- Api Key Authentication (AdminAPIAuthentication):
Parameters
Name | Type | Description | Notes |
---|---|---|---|
id | str | The UUID of the group to be removed. |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
Status code | Description | Response headers |
---|---|---|
200 | Successful | - |
400 | Bad Request | - |
401 | Access denied | - |
403 | Forbidden | - |
404 | Not Found | - |
409 | Conflict | - |
group_by_external_id_using_post
Group group_by_external_id_using_post(group_id)
Get a group by externalId
Get the specified group by externalId. Caller requires the GROUPS:VIEW permission.
Example
- Api Key Authentication (AdminAPIAuthentication):
Parameters
Name | Type | Description | Notes |
---|---|---|---|
group_id | GroupId |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
Status code | Description | Response headers |
---|---|---|
200 | Successful | - |
400 | Bad Request | - |
401 | Access denied | - |
403 | Forbidden | - |
404 | Not Found | - |
409 | Conflict | - |
group_using_get
Group group_using_get(id)
Get a group
Get the specified group. Caller requires the GROUPS:VIEW permission.
Example
- Api Key Authentication (AdminAPIAuthentication):
Parameters
Name | Type | Description | Notes |
---|---|---|---|
id | str | The UUID of the group to fetch. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
Status code | Description | Response headers |
---|---|---|
200 | Successful | - |
400 | Bad Request | - |
401 | Access denied | - |
403 | Forbidden | - |
404 | Not Found | - |
409 | Conflict | - |
groups_paged_using_post
GroupsPage groups_paged_using_post(search_parms)
List a page of groups
Returns groups for the provided search parameters. Caller requires the GROUPS:VIEW permission. The following searchByAttributes are supported:
- name: a string value that indicates the name of the group. Allowed operators are: EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS, STARTS_WITH, ENDS_WITH.
- type: a string with the value that indicates the type of the group. Allowed operator: EQUALS.
If you provide more than one search attribute, they are joined with an AND condition.
The orderByAttribute supports this attribute name: name.
Example
- Api Key Authentication (AdminAPIAuthentication):
Parameters
Name | Type | Description | Notes |
---|---|---|---|
search_parms | SearchParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
Status code | Description | Response headers |
---|---|---|
200 | Successful | - |
400 | Bad Request | - |
401 | Access denied | - |
403 | Forbidden | - |
404 | Not Found | - |
409 | Conflict | - |
groups_using_get
List[Group] groups_using_get()
List groups
List all groups. Caller requires the GROUPS:VIEW permission.
Example
- Api Key Authentication (AdminAPIAuthentication):
Parameters
This endpoint does not need any parameter.
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
Status code | Description | Response headers |
---|---|---|
200 | Successful | - |
400 | Bad Request | - |
401 | Access denied | - |
403 | Forbidden | - |
404 | Not Found | - |
409 | Conflict | - |
modify_user_authorization_group_associations_using_put
modify_user_authorization_group_associations_using_put(userid, request_body)
Modify user group membership
Modify the list of groups assigned to a specified user. Caller requires the USERS:EDIT permission.
Example
- Api Key Authentication (AdminAPIAuthentication):
Parameters
Name | Type | Description | Notes |
---|---|---|---|
userid | str | The UUID of the user whose group membership is to be modified. | |
request_body | List[str] |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
Status code | Description | Response headers |
---|---|---|
200 | Successful | - |
400 | Bad Request | - |
401 | Access denied | - |
403 | Forbidden | - |
404 | Not Found | - |
409 | Conflict | - |
update_group_using_put
Group update_group_using_put(id, group_parms)
Update a group
Update the specified group. Caller requires the GROUPS:EDIT permission.
Example
- Api Key Authentication (AdminAPIAuthentication):
Parameters
Name | Type | Description | Notes |
---|---|---|---|
id | str | The UUID of the group to update. | |
group_parms | GroupParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
Status code | Description | Response headers |
---|---|---|
200 | Successful | - |
400 | Bad Request | - |
401 | Access denied | - |
403 | Forbidden | - |
404 | Not Found | - |
409 | Conflict | - |