# Invitations

Workspace invitation lifecycle (`pending`, `accepted`, `declined`, `revoked`, `expired`).

 - [GET /workspaces/{workspace_id}/invitations](https://docs.vilna.io/apis/mgmt/api/invitation/list-workspace-invitations.md): Return workspace invitations in any lifecycle status.
 - [POST /workspaces/{workspace_id}/invitations](https://docs.vilna.io/apis/mgmt/api/invitation/create-workspace-invitation.md): Create an invitation by email with an optional bundle of project grants. Idempotent: returns `200 OK` if a pending invitation for the same recipient already exists.
 - [POST /workspaces/{workspace_id}/invitations/{invitation_id}/actions/revoke](https://docs.vilna.io/apis/mgmt/api/invitation/revoke-workspace-invitation.md): Revoke a pending invitation. Invitations in terminal status cannot be revoked.