---
title: "Decline an invitation"
description: "Turns an invitation down, so its link stops working."
url: "https://openemail.uk/docs/api/account/invitation-decline"
area: "API"
category: "Your account"
---

# Decline an invitation

Turns an invitation down, so its link stops working.

`POST /account/invitations/{invitationId}/decline`

## POST /account/invitations/{invitationId}/decline

Turns an invitation down, so its link stops working.

## Example

Needs `account:write`. Whoever sent it is told, and it cannot be taken back: they have to invite the person again.

**curl**

```
curl -X POST "$OE/account/invitations/winv_6bb640f5b99e47deb758f1f5/decline" -H "$AUTH"
```

**Response**

```
{ "object": "invitation", "id": "winv_6bb640f5b99e47deb758f1f5", "declined": true }
```

> An invitation the person already accepted is a 409 `invitation_accepted`.

## Reference

- [`POST /account/invitations/{invitationId}/decline`](https://openemail.uk/docs/api/reference/your-account#post-account-invitations-invitationid-decline): full reference