Join Requests API

7 endpoints.

Method	Path	Summary
`POST`	`/api/join-requests/{communityId}/bulk-invite-members`	Bulk invite members via Excel (admin only)
`POST`	`/api/join-requests/{communityId}/invite-member`	Invite a new member (admin only)
`GET`	`/api/join-requests/{communityId}/join-requests`	Get pending join requests (admin or moderator)
`POST`	`/api/join-requests/{communityId}/member-requests/{requestId}/approve`	Approve a join request (admin/moderator)
`POST`	`/api/join-requests/{communityId}/member-requests/{requestId}/reject`	Reject a join request (admin/moderator)
`POST`	`/api/join-requests/approve-join`	Approve join request via token (public route)
`POST`	`/api/join-requests/request-join`	Request to join a public community (public route)

Bulk invite members via Excel (admin only)

POST /api/join-requests/{communityId}/bulk-invite-members

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`communityId`	path	yes	string (uuid)	—

Request body (required) — multipart/form-data

Field	Type	Required	Description
`file`	string (binary)	yes	—

Responses

Status	Description	Body
`200`	Bulk invite processed	—
`403`	Permission denied	—

Invite a new member (admin only)

POST /api/join-requests/{communityId}/invite-member

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`communityId`	path	yes	string (uuid)	—

Request body (required) — application/json

Field	Type	Required	Description
`email`	string (email)	yes	—
`firstName`	string	no	—
`familyName`	string	no	—

Responses

Status	Description	Body
`200`	Member invited successfully	—
`403`	Permission denied	—

Get pending join requests (admin or moderator)

GET /api/join-requests/{communityId}/join-requests

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`communityId`	path	yes	string (uuid)	—
`page`	query	no	integer	—
`limit`	query	no	integer	—

Responses

Status	Description	Body
`200`	Paginated list of join requests	—
`403`	Permission denied	—

Approve a join request (admin/moderator)

POST /api/join-requests/{communityId}/member-requests/{requestId}/approve

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`communityId`	path	yes	string (uuid)	—
`requestId`	path	yes	string (uuid)	—

Responses

Status	Description	Body
`200`	Join request approved	—
`403`	Permission denied	—

Reject a join request (admin/moderator)

POST /api/join-requests/{communityId}/member-requests/{requestId}/reject

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`communityId`	path	yes	string (uuid)	—
`requestId`	path	yes	string (uuid)	—

Request body — application/json

Field	Type	Required	Description
`reason`	string	no	—

Responses

Status	Description	Body
`200`	Join request rejected	—
`403`	Permission denied	—

Approve join request via token (public route)

POST /api/join-requests/approve-join

Auth: Bearer JWT required.

Request body (required) — application/json

Field	Type	Required	Description
`token`	string	yes	—

Responses

Status	Description	Body
`200`	Join request approved	—

Request to join a public community (public route)

POST /api/join-requests/request-join

Auth: Bearer JWT required.

Request body (required) — application/json

Field	Type	Required	Description
`email`	string (email)	yes	—
`communityId`	string (uuid)	yes	—
`firstName`	string	no	—
`familyName`	string	no	—

Responses

Status	Description	Body
`200`	Join request submitted	—