Skip to content

๐Ÿค Join Community Army

Endpoint: POST /api/citizen/armies/{id}/join
Auth Required: โœ… Yes (Bearer Token)
Content-Type: application/json


๐Ÿ“Œ Description

This endpoint allows an authenticated citizen to join a community army.

Joining behavior depends on the army tier:

  • Tier 1 (Open Armies)
    โ†’ Citizen is added instantly as a member.

  • Tier 2 (Restricted Armies)
    โ†’ Citizen must submit additional eligibility details.
    โ†’ Membership is granted only after successful validation.

This design ensures both ease of participation and responsible civic engagement.


๐Ÿ” Authentication

Include the JWT access token in the Authorization header:


๐Ÿ”— Path Parameter

Parameter Type Required Description
id UUID โœ… Unique army ID

๐Ÿงพ Request Body

๐Ÿ”น Tier 1 Army (Open)

No request body is required.

```json {}