Skip to content

OwnInvitePage

A page of the user’s own invites, newest first, with what the user may do.

object
next_cursor

An opaque pagination cursor. Clients pass it back unchanged and never parse it.

string
>= 1 characters <= 256 characters
items
required
Array<object>

An invite that the user created as a member, which always has a limit of uses and an expiry.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
code
required

The code people enter on the registration page, 16 characters.

string
url
required

The registration page with the code filled in, to send to people.

string format: uri
max_uses
required

How many sign-ups the invite allows.

integer
>= 1
uses
required

How many people have signed up with the invite.

integer
state
required

What the invite allows now. usable: people may sign up with it. revoked: it was revoked. expired: it passed expires_at. exhausted: it was used max_uses times. creator_ineligible: a member created it who may no longer create invites (their permission or plan ended, the instance setting invite_creators changed, or the account is suspended, limited, or deleted); it works again when the member may.

string
Allowed values: usable revoked expired exhausted creator_ineligible
expires_at
required

When the invite stops working.

string format: date-time
created_at
required
string format: date-time
can_create
required

Whether the user may create invites now: the instance setting invite_creators is everyone or the user’s roles have create_invites, the account is neither suspended nor limited, its registration is approved, and the registration mode is not closed. It does not count the cap of usable invites (usable against limits.max_active). When it is false, cannot_create_reason says why; when it is true, cannot_create_reason is omitted.

boolean
cannot_create_reason

Why the user may not create invites of their own now, the first that holds of registration_closed: the registration mode is closed, which takes no new accounts; not_permitted: the instance setting invite_creators is not everyone and the user’s roles lack create_invites; not_approved: the registration of the account is not approved; restricted: the account is suspended or limited.

string
Allowed values: registration_closed not_permitted not_approved restricted
usable
required

How many usable invites the user holds now, which limits.max_active bounds.

integer
limits
required
object

Example generated

{
"next_cursor": "example",
"items": [
{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"code": "example",
"url": "https://example.com",
"max_uses": 1,
"uses": 1,
"state": "usable",
"expires_at": "2026-04-15T12:00:00Z",
"created_at": "2026-04-15T12:00:00Z"
}
],
"can_create": true,
"cannot_create_reason": "registration_closed",
"usable": 1,
"limits": {}
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site