Skip to main content
Decline Invite
Declines an invitation. Identity-matched (the caller must be the invite’s target) and verification-gated — a verified email is required, exactly as it is to accept. Without that gate, someone who signed up with another person’s address and never verified it could burn the real target’s invite by moving it to the terminal declined state. This is not a key-bypass gate: a service or master key acting as a named userId still requires that user to be verified. Marks the invite declined and fires workspace.invite.declined.

Path Parameters

string
required
The invitation UUID.

Body Parameters

string
Service/master keys only — the declining user (must be the invite’s target).

Response

Error Responses

A caller who is not the invitation’s target receives the same 404 as a non-existent invitation.
See also: useDeclineWorkspaceInvite