> ## 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.

# Listar os links de compartilhamento de um template

> Lista os links de compartilhamento de um template privado com modo, usos, limite, validade e revogação, sem os tokens.

Esta chamada lista todos os links de compartilhamento de um template privado, incluindo os revogados e expirados, para que você veja como cada um é usado. Os tokens nunca são retornados de novo: cada link mostra apenas os últimos 4 caracteres (`last4`) para diferenciá-los.

Precisa do escopo `templates:read` quando chamada com uma chave de API. Só o dono do template pode listar os links dele; um membro do workspace não pode.

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

O ID do template.

**workspace\_id** `string`

Se o template pertencer a um workspace, o ID do workspace.

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

### Resposta

**response** `object[]`

Os links.

**Mostrar objeto**

**id** `string`

O ID do link.

**template\_id** `string`

O template ao qual o link pertence.

**mode** `string`

`use` ou `full_copy`.

**last4** `string`

Os últimos 4 caracteres do token, para diferenciar os links.

**uses** `integer`

Quantas vezes o link foi usado.

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

O número máximo de usos, ou `null` para sem limite.

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

Quando o link expira, ou `null` quando não expira.

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

Quando o autor revogou o link, ou `null`.

**created\_at** `string`

Quando o link foi criado.

```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"
    }
  ]
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `API_KEY_SCOPE_DENIED`: A chave de API não tem o escopo `templates:read` (`403`).
* `TEMPLATE_NOT_FOUND`: O template não existe ou não é seu (`404`).
* `WORKSPACE_OWNER_ONLY`: Só o dono do workspace lista os links dos templates dele.

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


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