Network invitations

Network user invitations

List the network's user invitations

Returns the network's user invitations, including pending, accepted, revoked, and expired ones, each with its target email and granted role. Requires at least read-only access. Results are cursor-paginated and ordered by invitation id.

Invite a user to the network and email them an accept link

Creates an invitation for the given email with a membership role (admin or viewer) and emails the recipient a tokenized accept link. Requires the administrator role. Email delivery is best-effort and never fails the request, so the 201 response reports whether the email was sent and also returns the invite_url directly. The response includes the one-time accept URL, which is only surfaced at creation time.

Get a single invitation

Returns one invitation by id, including its current status. Requires at least read-only access. The recipient's accept token is never exposed here. Responds with 404 if the invitation does not belong to this network.

Revoke a pending invitation so its link can no longer be accepted

Marks a pending invitation as revoked, invalidating its accept link. Requires the administrator role. Only invitations that are still pending can be revoked; one that has already been accepted, revoked, or expired returns 409. Returns the updated invitation.