<!--
  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/list_share_links

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


# list_share_links

**What has been shared**

The share links this organisation has created, live or not, with who was invited and who has actually opened each one. Revoked and expired links are included, because "who had access last month" is a real question. Read-only.

- Access: read-only
- Calls: `/api/v1/share-links`

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `resourceType` | `document` \| `folder` \| `workspace` | no | Filter by what was shared |
| `resourceId` | string | no | Only links for this resource |
| `activeOnly` | boolean | no | true hides revoked and expired links |
| `page` | number | no |  |
| `limit` | number | no |  |

## Tool contract

```json
{
  "name": "list_share_links",
  "title": "What has been shared",
  "description": "The share links this organisation has created, live or not, with who was invited and who has actually opened each one. Revoked and expired links are included, because \"who had access last month\" is a real question. Read-only.",
  "access": "read",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/share-links",
  "arguments": {
    "resourceType": {
      "type": "enum",
      "required": false,
      "description": "Filter by what was shared",
      "values": [
        "document",
        "folder",
        "workspace"
      ]
    },
    "resourceId": {
      "type": "string",
      "required": false,
      "description": "Only links for this resource"
    },
    "activeOnly": {
      "type": "boolean",
      "required": false,
      "description": "true hides revoked and expired links"
    },
    "page": {
      "type": "number",
      "required": false,
      "description": ""
    },
    "limit": {
      "type": "number",
      "required": false,
      "description": ""
    }
  }
}
```