1
0
api/openapi/docs/GroupApi.md
2024-03-13 16:53:30 +09:00

5.1 KiB

\GroupApi

All URIs are relative to http://localhost

Method HTTP request Description
create_group POST /groups Create a new Group
delete_group DELETE /groups/{id} Deletes a Group by ID
list_group GET /groups List Groups
list_group_users GET /groups/{id}/users List attached Users
read_group GET /groups/{id} Find a Group by ID
update_group PATCH /groups/{id} Updates a Group

create_group

models::GroupCreate create_group(create_group_request) Create a new Group

Creates a new Group and persists it to storage.

Parameters

Name Type Description Required Notes
create_group_request CreateGroupRequest Group to create [required]

Return type

models::GroupCreate

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

delete_group

delete_group(id) Deletes a Group by ID

Deletes the Group with the requested ID.

Parameters

Name Type Description Required Notes
id i32 ID of the Group [required]

Return type

(empty response body)

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list_group

Vecmodels::GroupList list_group(page, items_per_page) List Groups

List Groups.

Parameters

Name Type Description Required Notes
page Option<i32> what page to render
items_per_page Option<i32> item count to render per page

Return type

Vecmodels::GroupList

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list_group_users

Vecmodels::GroupUsersList list_group_users(id, page, items_per_page) List attached Users

List attached Users.

Parameters

Name Type Description Required Notes
id i32 ID of the Group [required]
page Option<i32> what page to render
items_per_page Option<i32> item count to render per page

Return type

Vecmodels::GroupUsersList

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

read_group

models::GroupRead read_group(id) Find a Group by ID

Finds the Group with the requested ID and returns it.

Parameters

Name Type Description Required Notes
id i32 ID of the Group [required]

Return type

models::GroupRead

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

update_group

models::GroupUpdate update_group(id, update_group_request) Updates a Group

Updates a Group and persists changes to storage.

Parameters

Name Type Description Required Notes
id i32 ID of the Group [required]
update_group_request UpdateGroupRequest Group properties to update [required]

Return type

models::GroupUpdate

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]