project-members
6 endpoints
get /projects/{projectId}/members
List a project's members
Requires authentication
Returns the project member roster with each member's role and trimmed user.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| projectId | path | integer | yes | Project id |
Responses
- 200 OK · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
post /projects/{projectId}/members
Add a member to a project
Requires authentication
Adds an org member to the project (defaults to the member role) and returns the created membership.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| projectId | path | integer | yes | Project id |
Request body: handler.AddMemberRequest
| Name | Type | Required | Description |
|---|---|---|---|
| role | domain.ProjectRole | no | |
| userId | integer | no |
Responses
- 201 Created · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
patch /projects/{projectId}/members/{userId}
Update a project member's role
Requires authentication
Updates a member's project role and returns the updated membership.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| projectId | path | integer | yes | Project id |
| userId | path | integer | yes | Target user id |
Request body: handler.UpdateRoleRequest
| Name | Type | Required | Description |
|---|---|---|---|
| role | domain.ProjectRole | no |
Responses
- 200 OK · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
delete /projects/{projectId}/members/{userId}
Remove a member from a project
Requires authentication
Removes a member from the project and returns a confirmation message.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| projectId | path | integer | yes | Project id |
| userId | path | integer | yes | Target user id |
Responses
- 200 OK · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
get /projects/{projectId}/members/assignable
List users assignable to project tasks
Requires authentication
Returns all users who can be assigned to tasks in the project.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| projectId | path | integer | yes | Project id |
Responses
- 200 OK · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
get /projects/{projectId}/members/available
List org members not yet on the project
Requires authentication
Returns org members eligible to be added to the project.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| projectId | path | integer | yes | Project id |
Responses
- 200 OK · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope