Preview a workspace invite from its token
Resolves an invite token to the workspace name, icon, accent color, invited email, role, and status so the sign-in screen can show what is being joined. No authentication; the token in the path is the credential. A pending invite past its expiry is reported with status `expired`, and an unknown token is not found.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspace-invites/string"{ "data": { "id": "string", "workspaceId": "string", "workspaceName": "string", "workspaceSlug": "string", "workspaceIcon": "initials", "workspaceAccentColor": "string", "email": "string", "role": "owner", "status": "pending", "expiresAt": "string", "createdAt": "string" }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Revoke a pending workspace invite
Marks the invite revoked so its token can no longer be redeemed, cancels the queued invitation email, and returns the resulting invite. Requires `members:invite`. An unknown invite is not found and one that is no longer pending conflicts.
Accept a workspace invite using its token
Redeems the invite token, creates the membership at the invited role, and returns the joined workspace; billable seats are re-synced afterwards. The caller must be authenticated with a synced profile and a verified email matching the invited address — an unverified or different email is refused. Unknown, already-closed, and expired invites are rejected.