Invitations
Invitations endpoints of the bizSupply API.
Last updated: 2026-07-21
POST /api/v1/invitations
Create an invitation to an organization (OWNER or ADMIN only).
Request body
application/json→CreateInvitationRequest
Responses
| Status | Description |
|---|---|
200 | Created invitation |
403 | Insufficient role |
409 | Invitation already exists for this email |
GET /api/v1/invitations/me
List pending invitations for the current user.
Responses
| Status | Description |
|---|---|
200 | List of pending invitations |
401 | Authentication required |
GET /api/v1/invitations/organization/{orgId}
List invitations for 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 invitations |
403 | Insufficient role |
POST /api/v1/invitations/{id}/accept
Accept an invitation to join an organization.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
id | path | yes | Invitation UUID. |
Responses
| Status | Description |
|---|---|
200 | Invitation accepted, membership created |
401 | Authentication required |
404 | Invitation not found |
POST /api/v1/invitations/{id}/reject
Reject an invitation.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
id | path | yes | Invitation UUID. |
Responses
| Status | Description |
|---|---|
200 | Invitation rejected |
404 | Invitation not found |
POST /api/v1/invitations/{id}/resend
Resend an invitation email (OWNER or ADMIN only).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
id | path | yes | Invitation UUID. |
Responses
| Status | Description |
|---|---|
200 | Invitation resent |
403 | Insufficient role |
404 | Invitation not found |
POST /api/v1/invitations/{id}/revoke
Revoke an invitation (OWNER or ADMIN only).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
id | path | yes | Invitation UUID. |
Responses
| Status | Description |
|---|---|
200 | Invitation revoked |
403 | Insufficient role |
404 | Invitation not found |
GET /api/v1/invitations/{token}
Get an invitation by token (public endpoint for acceptance flow).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
token | path | yes | Invitation token from the email link. |
Responses
| Status | Description |
|---|---|
200 | Invitation details |
404 | Invitation not found or expired |