Skip to main content

invitations.decline

Decline an organization invitation

Request
POST/api/v1/invitations/{invitationId}/decline
Scope required
organizations:write
Effect
Changes data. Send an Idempotency-Key if you might retry it.
Acts on
Acts on the account’s own job search.
MCP tool
invitations_decline
Environment
Live and sandbox alike.
Request body
JSON.

What it does

Turns down an invitation without joining the organization. Nothing about this account is disclosed to them by declining, and the same organization can invite the account again later. An invitation already answered, revoked or expired is refused, and one addressed to anybody else answers 404. Answers 200 with an empty object. `invitations.accept` is the other answer.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
NameSent inRequirementAccepts
invitationIdpathRequiredstring

Response

Answers 200 with no body.

Examples

Turn down an invitation

Turn down an invitation — request
curl -s -X POST https://www.jobapplicationtracking.com/api/v1/invitations/inv_3f1b0c2e-6d5a-4f7b-9c8d-0a1b2c3d4e5f/decline \
  -H "Authorization: Bearer $JAT_KEY"
Turn down an invitation — response
{}

Related operations