getInvitationById
Retrieves an invitation by its unique identifier.
This method searches for an invitation with the specified invitationId
and returns it if found. Invitations can represent either sent or received invitations, depending on the user's context.
Behavior:
Returns
null
if no invitation matches the providedinvitationId
.
Usage Notes:
Ensure the
invitationId
is a valid and existing identifier before calling this method.
Return
An Invitation object if found, or null
if no matching invitation exists.
Parameters
invitationId
A non-null String representing the unique identifier of the invitation to retrieve.