diff --git a/openapi/mv-openapi-root.yaml b/openapi/mv-openapi-root.yaml index eb33b1f..b01fe42 100644 --- a/openapi/mv-openapi-root.yaml +++ b/openapi/mv-openapi-root.yaml @@ -33,6 +33,13 @@ paths: '/users/{user-id}': $ref: 'paths/users@{user-id}.yaml' tags: + - name: User Management + description: | + All the paths for: + - user creation + - authentication + - security + - trust levels - name: Poll Indexation description: > Paths about indexing (public) polls. @@ -60,3 +67,6 @@ components: userAuth: type: http scheme: bearer + adminAuth: + type: http + scheme: bearer diff --git a/openapi/paths/polls@{poll-id}@ballots@{ballot-id}.yaml b/openapi/paths/polls@{poll-id}@ballots@{ballot-id}.yaml index b4ac6ea..29fcb6e 100644 --- a/openapi/paths/polls@{poll-id}@ballots@{ballot-id}.yaml +++ b/openapi/paths/polls@{poll-id}@ballots@{ballot-id}.yaml @@ -13,8 +13,8 @@ get: operationId: get-ballot summary: Gets a ballot by ID tags: - - Poll Participation - Poll Deliberation + - Poll Participation responses: '200': description: A ballot object diff --git a/openapi/paths/users.yaml b/openapi/paths/users.yaml index f4e24e0..7076045 100644 --- a/openapi/paths/users.yaml +++ b/openapi/paths/users.yaml @@ -1,6 +1,9 @@ +# get: operationId: get-users - summary: Gets all users. + summary: Gets all users + tags: + - User Management responses: '200': description: OK @@ -10,9 +13,13 @@ get: type: array items: $ref: ../components/schemas/user.yaml + security: + - adminAuth: [] post: operationId: create-user summary: Creates an user + tags: + - User Management requestBody: required: true content: diff --git a/openapi/paths/users@{user-id}.yaml b/openapi/paths/users@{user-id}.yaml index 2cdf85a..124f77a 100644 --- a/openapi/paths/users@{user-id}.yaml +++ b/openapi/paths/users@{user-id}.yaml @@ -8,6 +8,8 @@ parameters: get: operationId: get-user summary: Gets a user by ID + tags: + - User Management responses: '200': description: OK @@ -20,6 +22,8 @@ get: patch: operationId: update-user summary: Updates a user + tags: + - User Management requestBody: required: true content: @@ -41,6 +45,8 @@ patch: delete: operationId: delete-user summary: Deletes a user + tags: + - User Management responses: '200': description: OK