diff --git a/docs/_extra/api-reference/hypothesis-v1.yaml b/docs/_extra/api-reference/hypothesis-v1.yaml index ef31dfbf8c6..a13f57568e7 100644 --- a/docs/_extra/api-reference/hypothesis-v1.yaml +++ b/docs/_extra/api-reference/hypothesis-v1.yaml @@ -930,6 +930,30 @@ paths: $ref: '#/components/schemas/Membership' /groups/{id}/members/{user}: + # ---------------------------------------------------------- + # GET groups/{id}/members/{user} - Get group membership + # ---------------------------------------------------------- + get: + tags: + - memberships + summary: Get group membership + description: Get a user's membership of a group. + Authenticated user must have read access to the group. + Does not require authentication for reading members of public groups. + security: + - ApiKey: [] + - {} + parameters: + - $ref: '#/components/parameters/GroupID' + - $ref: '#/components/parameters/UserID' + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/Membership' + # ---------------------------------------------------------- # POST groups/{id}/members/{user} - Add user to group # ---------------------------------------------------------- diff --git a/docs/_extra/api-reference/hypothesis-v2.yaml b/docs/_extra/api-reference/hypothesis-v2.yaml index a8c16d78318..1e327c42a52 100644 --- a/docs/_extra/api-reference/hypothesis-v2.yaml +++ b/docs/_extra/api-reference/hypothesis-v2.yaml @@ -928,6 +928,30 @@ paths: $ref: '#/components/schemas/Membership' /groups/{id}/members/{user}: + # ---------------------------------------------------------- + # GET groups/{id}/members/{user} - Get group membership + # ---------------------------------------------------------- + get: + tags: + - memberships + summary: Get group membership + description: Fetch a user's membership of a group. + Authenticated user must have read access to the group. + Does not require authentication for reading members of public groups. + security: + - ApiKey: [] + - {} + parameters: + - $ref: '#/components/parameters/GroupID' + - $ref: '#/components/parameters/UserID' + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/Membership' + # ---------------------------------------------------------- # POST groups/{id}/members/{user} - Add user to group # ----------------------------------------------------------