Preview a library invitation
Return library attribution and the caller’s current eligibility without admitting them or reserving a place. Invalid secrets and unavailable libraries return the same generic 404; retry with a valid, available invitation link.
Authorizations
First-party Gumnut app session (Clerk session JWT). Only the Gumnut web and mobile apps can obtain one — API keys and OAuth tokens cannot manage credentials or library sharing, so these operations are not callable with the credentials this API otherwise accepts.
Path Parameters
Invitation identifier.
Body
Opaque secret from the invitation URL fragment.
1 - 64Response
Successful Response
Library attribution without content or storage details.
Previewed invitation identifier.
Role offered if this account joins.
viewer, collaborator Invitation expiration instant.
Current eligibility; preview does not reserve a place.
joinable, already_member, expired, disabled, exhausted, new_invitation_required Existing active role, or null when the account has no current access.
owner, viewer, collaborator