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

# List the Share Links of a Template

> Lists the share links of a private template with their mode, uses, limit, expiry and revocation, without the tokens.

This call lists every share link of a private template, including revoked and expired ones, so you can see how each is used. Tokens are never returned again: each link shows only the last 4 characters (`last4`) to tell them apart.

Needs the `templates:read` scope when called with an API key. Only the owner of the template can list its links; a workspace member cannot.

**template\_id** `string` *required*

The template ID.

**workspace\_id** `string`

If the template belongs to a workspace, the workspace's ID.

```bash cURL theme={null}
curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
  -H "Authorization: Bearer $VERTRA_API_KEY"
```

### Response

**response** `object[]`

The links.

**Toggle object**

**id** `string`

The link ID.

**template\_id** `string`

The template the link belongs to.

**mode** `string`

`use` or `full_copy`.

**last4** `string`

The last 4 characters of the token, to tell links apart.

**uses** `integer`

How many times the link was used.

**max\_uses** `integer | null`

The maximum number of uses, or `null` for no limit.

**expires\_at** `string | null`

When the link expires, or `null` when it does not expire.

**revoked\_at** `string | null`

When the author revoked the link, or `null`.

**created\_at** `string`

When the link was created.

```json Response theme={null}
{
  "response": [
    {
      "id": "lnk-abc123def456",
      "template_id": "tpl-abc123def456",
      "mode": "use",
      "last4": "x9Qa",
      "uses": 3,
      "max_uses": 10,
      "expires_at": "2026-11-03T14:02:00Z",
      "revoked_at": null,
      "created_at": "2026-10-27T14:02:00Z"
    }
  ]
}
```

### Error Responses

**code** `string`

The error code indicating the reason for the failure. Possible values:

* `API_KEY_SCOPE_DENIED`: The API key does not have the `templates:read` scope (`403`).
* `TEMPLATE_NOT_FOUND`: The template does not exist or is not yours (`404`).
* `WORKSPACE_OWNER_ONLY`: Only the workspace owner lists the links of its templates.

```json Error Response theme={null}
{
  "code": "TEMPLATE_NOT_FOUND"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.