Organization Members
Organization Members endpoints of the bizSupply API.
Last updated: 2026-07-21
GET /api/v1/organizations/{orgId}/members
List members of an organization (OWNER or ADMIN only).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
orgId | path | yes | Organization UUID. |
pageable | query | yes |
Responses
| Status | Description |
|---|---|
200 | Paginated list of members |
403 | Insufficient role |
POST /api/v1/organizations/{orgId}/members
Add a member to an organization (OWNER or ADMIN only).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
orgId | path | yes | Organization UUID. |
Request body
application/json→AddMemberRequest
Responses
| Status | Description |
|---|---|
200 | Created membership |
403 | Insufficient role |
409 | User is already a member |
POST /api/v1/organizations/{orgId}/members/transfer-ownership
Transfer organization ownership to another member (OWNER only).
The current OWNER is downgraded to ADMIN after the transfer.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
orgId | path | yes | Organization UUID. |
Request body
application/json→TransferOwnershipRequest
Responses
| Status | Description |
|---|---|
200 | Ownership transferred |
403 | Not the current OWNER |
404 | New owner is not a member |
DELETE /api/v1/organizations/{orgId}/members/{userId}
Remove a member from an organization (OWNER or ADMIN only).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
orgId | path | yes | Organization UUID. |
userId | path | yes | Target member's user UUID. |
Responses
| Status | Description |
|---|---|
204 | Member removed |
403 | Insufficient role |
404 | User is not a member |
PUT /api/v1/organizations/{orgId}/members/{userId}/role
Update a member's role in an organization (OWNER or ADMIN only).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
orgId | path | yes | Organization UUID. |
userId | path | yes | Target member's user UUID. |
Request body
application/json→UpdateMemberRoleRequest
Responses
| Status | Description |
|---|---|
200 | Updated membership |
403 | Insufficient role |
404 | User is not a member |