E011: Decline invitation

POST /api/invitations/decline

Marks a pending invitation as declined. Triggered from My Invitations by an authenticated user who received the invitation and chooses not to accept. Operates on the invitation id, not the token (the user has already authenticated, so they can be matched by email rather than by an opaque link).

Authentication

User-scoped route. Requires Authorization: Bearer <firebase-id-token>; X-Org-Id is not required — the user identity alone is sufficient. Access: Member.

Request

{
  "token": "opaque-string"
}

Response — 204 No Content

Empty response body.

Errors

HTTP	code	Condition
404	not_found	Unknown token.
422	validation_failed	Firebase token email does not match the invitation email.
409	invalid_transition	Invitation is already accepted or revoked.

Workflow

Calls W011 Decline invitation.