Skip to content

What an invitation link is for

POST
/api/v1/invitations/preview
curl --request POST \
--url https://api.crossmart.io/api/v1/invitations/preview \
--header 'Content-Type: application/json' \
--data '{ "token": "example" }'

Open to anyone with the link, so it can be shown before signing in. 404 when the link is unknown, used, revoked or expired.

Media typeapplication/json
object
token
required
string
<= 128 characters

Example generated

{
"token": "example"
}
Media typeapplication/json
object
workspaceName
required

The workspace’s display name

string
inviterName
required
string
email
required

The address invited; accepting needs an account with it

string
role
required
string
Allowed values: OWNER ADMIN EDITOR APPROVER VIEWER CUSTOM
roleName
required

The role as people read it

string
expiresAt
required
string format: date-time

Example

{
"role": "OWNER",
"roleName": "Editor"
}