Skip to main content

How long is the user invitation link valid?

Invitations can be triggered from the Admin Dashboard or the Group Admin Dashboard, allowing users to register for the invited instance.

Expiration periods​

The auth URL (shortened link) sent to users expires after 1 week (7 days). After expiration, users will be redirected to an error page stating that the link has expired.

Note
The initiate_login_uri is also shortened. This ensures that email delivery is not affected by long URLs, which could potentially cause delivery issues if the domain differs.

Invite ID​

The invite ID is valid for 180 days or until it is:

  • Used (accepted by the user)
  • Revoked by an administrator

Reinitiating invitations​

It is possible to reinitiate an invitation, which creates a new shortened link with a fresh 7-day expiration period. This is useful when:

  • The original invitation link has expired
  • The user didn't receive the invitation email/SMS
  • You need to resend the invitation

Invitation endpoints​

POST /useractions-srv/invitations - Initiate Invitation​

Creates a new invitation for a user.

Functionality:

  • Validates permissions
  • Creates auth URL (shortened)
  • Sends notification (email/SMS)

Required scopes: cidaas:users_invite

GET /useractions-srv/invitations/{inviteId} - Read Invitation (Public)​

Public endpoint to read invitation details and prefill the invitation form.

Functionality:

  • Returns invitation details for form prefilling
  • Returns 204 if invitation not found
  • No authentication required (public endpoint)

PATCH /useractions-srv/invitations/{inviteId} - Change Invitation State​

Updates the invitation state: reinitiated, revoked, or rejected.

Functionality:

  • Updates invitation state
  • Resends invitation if state is set to reinitiated
  • Creates a new shortened link when reinitiated

Required scopes: cidaas:users_invite or admin roles

Available states:

  • reinitiated - Resend invitation with a new shortened link
  • revoked - Cancel the invitation
  • rejected - Mark invitation as rejected

For detailed information on how to invite users, see Create and Invite Users.

Need support?​

For assistance, visit our Support Portal.