/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Decline Invitation

Decline Invitation

Turn down an invitation.

POST/v1/invites/{token}/declineTry it

Turns an invitation down. Its status becomes declined and it can no longer be accepted. To invite the same address again, an admin sends a new invitation — a declined invitation can't be resent.

Note

Public — no credential needed. The invitee may not have an account; the token from the invitation email is what grants access, so anyone holding a forwarded link can decline it. Any plan.

Path Parameters

NameDescription
token:stringpathRequired
The invitation token from the link in the invitation email.

Response — 200 OK

Declining an invitation that is already declined returns the same response. The first decline is recorded in the workspace's audit log as org.invite.declined.

Error Responses

400 Bad Request

invite_not_pending — the invitation was already accepted, revoked or marked expired:

json
{
"error": {
"code": "invite_not_pending",
"message": "This invitation has already been used or revoked",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}

invite_expired — the invitation has passed its expiry. It is marked expired at the same time:

json
{
"error": {
"code": "invite_expired",
"message": "This invitation has expired.",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}

404 Not Found

not_found ("Invitation not found") — no invitation has this token.

Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X POST https://api.syntext.dev/v1/invites/4e7a9c1b-3d5f-4a8c-b2e4-6f8a0c2e4b67/decline
Responseapplication/json
200OK
{
"data": {
"declined": true
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext