# Withdraw a merchant invitation

Takes a merchant's link down: the invitation is stamped dead in place and stops working, and the row STAYS so the record of what was shared survives. Revoking twice succeeds. Any seat that can open the deal may revoke, not only the person who minted it. An invitation belonging to another deal is a 404.

Access class: `def:read`.

## Endpoint

`DELETE /v1/definitions/{key}/rows/{rowId}/merchant-invitations/{invitationId}`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| key | path | string | Yes |
| rowId | path | string | Yes |
| invitationId | path | string | Yes |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "revoked": true
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```