Sign in

v10

latestOpenAPI 3.0.1raw.githubusercontent.com2025-12-033223581.2 MB
Invitations

Retrieve Invitation

Retrieve the specified invitation with the given UUID.

get/organizations/{orgId}/invitations/{id}

Path parameters

orgIdstring required

UUID of the organization. The Organization represents your company as a direct customer of the m3ter service.

idstring required

UUID of the specific invitation to retrieve.

Response

Returns the specified invitation

idstring required

The UUID of the entity.

versioninteger

The version number:

  • Create: On initial Create to insert a new entity, the version is set at 1 in the response.
  • Update: On successful Update, the version is incremented by 1 in the response.
emailstring required

The email address of the invitee. The invitation will be sent to this email address.

permissionPolicyIdsstring[] required

The IDs of the permission policies the invited user has been assigned. This controls the access rights and privileges that this user will have when working in the m3ter Organization.

firstNamestring required

The first name of the invitee.

lastNamestring required

The surname of the invitee.

dtEndAccessstring date-time required

The date that access will end for the user (in ISO-8601 format). If this is blank, there is no end date meaning that the user has permanent access.

dtExpirystring date-time required

The date when the invite expires (in ISO-8601 format). After this date the invited user can no longer accept the invite. By default, any invite is valid for 30 days from the date the invite is sent.

invitingPrincipalIdstring required

The UUID of the user who sent the invite.

acceptedboolean required

Boolean indicating whether the user has accepted the invitation.

  • TRUE - the invite has been accepted.
  • FALSE - the invite has not yet been accepted.
dtCreatedstring date-time

The DateTime when the invitation was created (in ISO-8601 format).

dtLastModifiedstring date-time

The DateTime when the invitation was last modified (in ISO-8601 format).

createdBystring

The UUID of the user who created the invitation.

lastModifiedBystring

The UUID of the user who last modified the invitation.