# Group Questions

API endpoints for managing group entry questions. Groups can require prospective members to answer questions before joining. Questions support multiple types (text, single choice, multiple choice) and are used to screen members when the group's join mode is set to QUESTIONS. Answers are validated and generate a token that can be used during the join process.

## Get all questions for a group

 - [GET /api/v1/groups/{groupId}/questions](https://docs.wellesley.social/openapi/group-questions/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1questions/get.md): Retrieves the complete list of questions that prospective members must answer when joining the group. Questions are returned in order based on their ordering value (lowest first). This endpoint is not accessible for groups with INVITE_ONLY join mode. Authentication is required to prevent question harvesting.

## Create a new group question

 - [POST /api/v1/groups/{groupId}/questions](https://docs.wellesley.social/openapi/group-questions/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1questions/post.md): Adds a new question that prospective members must answer when joining the group. Requires GroupQuestions.Manage permission. Questions can be of type TEXT (free-form answer), SINGLE_CHOICE (one option), or MULTIPLE_CHOICE (multiple options). For choice questions, provide the available options in the choices array. The creation is tracked in the audit log.

RBAC: requires GroupQuestions.Manage

## Submit answers to group entry questions

 - [POST /api/v1/groups/{groupId}/questions/answers](https://docs.wellesley.social/openapi/group-questions/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1questions~1answers/post.md): Submits answers to all required group questions as part of the join process. Returns a token that must be provided when calling the join endpoint. The group must have questions enabled (joinQuestions.show = true) and the user must not already be a member. Answers are validated against the current questions and stored for review by group administrators. The token expires after a configured period.

## Update an existing group question

 - [PUT /api/v1/groups/{groupId}/questions/{questionId}](https://docs.wellesley.social/openapi/group-questions/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1questions~1%7Bquestionid%7D/put.md): Modifies an existing question's text, type, choices, or ordering. Requires GroupQuestions.Manage permission. When changing question type, ensure the choices array is appropriate (empty for TEXT, populated for SINGLE_CHOICE/MULTIPLE_CHOICE). All fields must be provided in the update. Changes are tracked in the audit log for compliance.

RBAC: requires GroupQuestions.Manage

## Delete a group question

 - [DELETE /api/v1/groups/{groupId}/questions/{questionId}](https://docs.wellesley.social/openapi/group-questions/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1questions~1%7Bquestionid%7D/delete.md): Permanently removes a question from the group's entry requirements. Requires GroupQuestions.Manage permission. This action cannot be undone. Any existing answers to this question are preserved for audit purposes but will not be evaluated for new join requests. The deletion is recorded in the audit log.

RBAC: requires GroupQuestions.Manage