# Invitation

Manage user invitations with IAM permissions.

## Creates an invitation for a new user. An invitation email is sent with a link to complete registration.
For each requested permission, the caller must have "iam.policy.write" over the requested scope.

 - [POST /v1/invitations](https://developer.aritma.com/apis/platform/iam/openapi/iam-openapi/invitation/createinvitation.md): Required IAM actions (all required, on scope /): tenant.subjects.manage

## Returns a paginated list of invitations for the current tenant.

 - [GET /v1/invitations](https://developer.aritma.com/apis/platform/iam/openapi/iam-openapi/invitation/getinvitations.md): Required IAM actions (all required, on scope /): tenant.subjects.manage

## Returns a single invitation by id.

 - [GET /v1/invitations/{id}](https://developer.aritma.com/apis/platform/iam/openapi/iam-openapi/invitation/getinvitation.md): Required IAM actions (all required, on scope /): tenant.subjects.manage

## Cancels a pending invitation.

 - [DELETE /v1/invitations/{id}](https://developer.aritma.com/apis/platform/iam/openapi/iam-openapi/invitation/cancelinvitation.md): Required IAM actions (all required, on scope /): tenant.subjects.manage, iam.policy.write

## Resends the invitation email and resets the expiry. Only valid for pending invitations.
For each requested permission, the caller must have "iam.policy.write" over the requested scope.

 - [POST /v1/invitations/{id}/resend](https://developer.aritma.com/apis/platform/iam/openapi/iam-openapi/invitation/resendinvitation.md): Required IAM actions (all required, on scope /): tenant.subjects.manage