> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Disable join link

> Soft-revoke a join link so it stops admitting new signups

`DELETE /api/v2/storefront/join-links/{linkId}`

Soft-revokes a join link. The link is marked inactive (`active: false`, `revokedAt` set) and stops admitting new signups. Buyers who already joined keep their accounts — disabling a link only closes the door to new entrants.

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl -X DELETE https://api.interchange.io/api/v2/storefront/join-links/5571 \
    -H "Authorization: Bearer $SCOPE3_API_KEY"
  ```
</CodeGroup>

## Parameters

| Field    | Type          | Required | Notes                                                                          |
| -------- | ------------- | -------- | ------------------------------------------------------------------------------ |
| `linkId` | string (path) | Yes      | The join link `id`. Must be a positive integer belonging to your organization. |

## Response

`200 OK` confirming the revocation:

```json theme={null}
{
  "disabled": true,
  "id": "5571"
}
```

## Errors

* `400 VALIDATION_ERROR` — `linkId` is not a positive integer.
* `401 UNAUTHORIZED` — missing or invalid API key.
* `403 CUSTOMER_ROLE_DENIED` — the API key is not a seller account; only sellers manage join links.
* `404 NOT_FOUND` — no active link with this `id` on your organization's storefronts.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Join-link tasks" href="/v2/storefront/join-links/tasks" icon="list-check">
    All operations
  </Card>

  <Card title="List join links" href="/v2/storefront/join-links/tasks/list-join-links" icon="list">
    Find a link's id
  </Card>

  <Card title="Create join link" href="/v2/storefront/join-links/tasks/create-join-link" icon="plus">
    Mint a replacement link
  </Card>

  <Card title="Errors" href="/v2/reference/errors" icon="triangle-exclamation">
    Shared error contract
  </Card>
</CardGroup>