Skip to main content
POST
Create Invite

Authorizations

Authorization
string
header
required

A floo_ API key.

Headers

X-Floo-Org-Id
string<uuid>

Organization to act in; defaults to the one joined most recently.

Path Parameters

app_id
string<uuid>
required

Body

application/json

Invite one global floo identity to an app.

email
string<email>
required
role
enum<string>
default:member

Authorization role inside a tenant app, never the floo control plane.

Available options:
member,
admin

Response

Successful Response

Create/resend result; the raw URL is returned exactly once.

id
string<uuid>
required
app_id
string<uuid>
required
email
string
required
role
enum<string>
required

Authorization role inside a tenant app, never the floo control plane.

Available options:
member,
admin
status
enum<string>
required

Lifecycle state of an app invitation.

Available options:
pending,
accepted,
revoked,
expired
invited_by_user_id
string<uuid> | null
required
expires_at
string<date-time>
required
accepted_at
string<date-time> | null
required
revoked_at
string<date-time> | null
required
delivery_status
enum<string>
required

Latest non-secret delivery outcome for an invitation.

Available options:
pending,
sent,
failed,
unknown
delivery_attempted_at
string<date-time> | null
required
delivery_provider_id
string | null
required
delivery_failure_class
string | null
required
created_at
string<date-time>
required
invite_url
string
required