<!--
  immut documentation, machine-readable.

  Everything in one file:  https://www.immut.io/llms-full.txt
    What immut is, which integration path to choose, authentication and scopes, and the COMPLETE
    API reference: every endpoint with parameters, responses and a runnable curl. Fetch this first
    if you intend to call the API.

  Index of all pages:      https://www.immut.io/llms.txt
  OpenAPI contract:        https://www.immut.io/docs/openapi.json
  This page as HTML:       https://www.immut.io/docs/mcp/revoke_share_link

  Any page on this site is available as raw markdown by appending .md to its URL.
-->


# revoke_share_link

**Revoke a share link**

Stop a link working. Immediate: the next attempt to open it fails. ⚠️ It cannot un-send what was already downloaded, so say that when you confirm it.

- Access: write
- Calls: `/api/v1/share-links/`

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `shareLinkId` | string | **yes** | The share link to revoke |

## Tool contract

```json
{
  "name": "revoke_share_link",
  "title": "Revoke a share link",
  "description": "Stop a link working. Immediate: the next attempt to open it fails. ⚠️ It cannot un-send what was already downloaded, so say that when you confirm it.",
  "access": "write",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/share-links/",
  "arguments": {
    "shareLinkId": {
      "type": "string",
      "required": true,
      "description": "The share link to revoke"
    }
  }
}
```