Skip to content

Decline an invitation

POST
/api/users/me/invitations/{id}/decline

Marks the invitation as "declined" for the authenticated user. Only pending invitations can be declined (400 otherwise). No request body is required.

Authorizations

ApiToken

Long-lived API token created via POST /api/api-tokens (returned once in plaintext).

Type
API Key (header: X-API-TOKEN)
or
JWT

JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer .

Type
HTTP (bearer)

Parameters

Path Parameters

id*

invitation identifier

Type
string
Required

Request Body

JSON
{
  
"id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  
"organization": "/api/organizations/1",
  
"email": "alice@example.com",
  
"role": "MANAGER",
  
"status": "pending",
  
"invitedBy": "https://example.com/",
  
"createdAt": "2026-07-01T10:15:30+00:00",
  
"expiresAt": "2026-07-08T10:15:30+00:00",
  
"acceptedAt": "2026-07-02T09:00:00+00:00",
  
"expired": true
}

Responses

invitation resource created

JSON
{
  
"@context": "string",
  
"@id": "string",
  
"@type": "string",
  
"id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  
"organization": {
  
  
"@context": "string",
  
  
"@id": "string",
  
  
"@type": "string",
  
  
"name": "Acme GmbH"
  
},
  
"email": "alice@example.com",
  
"role": "MANAGER",
  
"status": "pending",
  
"invitedBy": {
  
  
"@context": "string",
  
  
"@id": "string",
  
  
"@type": "string",
  
  
"firstName": "Jane",
  
  
"lastName": "Doe"
  
},
  
"createdAt": "2026-07-01T10:15:30+00:00",
  
"expiresAt": "2026-07-08T10:15:30+00:00",
  
"acceptedAt": "2026-07-02T09:00:00+00:00"
}

Playground

Authorization
Variables
Key
Value
Body

Samples

Powered by VitePress OpenAPI