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

# Criar um link de compartilhamento para um template

> Cria um link de compartilhamento para um template privado, no modo de uso ou de cópia completa, com limite de usos e validade opcionais.

Esta chamada cria um link de compartilhamento para um template privado e responde `201` com o link e o token dele. **O token é mostrado somente nesta resposta e não pode ser recuperado**: guarde-o agora. Só um hash dele é mantido, e a resposta não é armazenada em cache. Um token começa com `vtpl_`.

Um link pode ter um de dois modos. Um link `use` permite que quem o abrir crie as próprias aplicações a partir do template, sem copiá-lo. Um link `full_copy` dá a essa pessoa um template privado próprio, independente do seu, que conta no limite dela de 5 templates privados. `full_copy` exige que `share.full_copy` esteja `true` no template, e não está disponível para um [template fechado](https://docs.vertracloud.app/pt-br/templates/use/closed-templates.md) nem para uma versão que tenha variáveis `env_hidden`. Leia [Links de compartilhamento](https://docs.vertracloud.app/pt-br/templates/create/share-links.md) antes de escolher.

Precisa do escopo `templates:write` quando chamada com uma chave de API. Só o dono do template pode criar links; em um workspace, um membro nem consegue listá-los. Quem recebe o link vê o aviso "Não verificado pela Vertra" na prévia.

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

O ID do template.

**workspace\_id** `string`

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

**mode** `string`

`use` ou `full_copy`. Padrão `use`.

**max\_uses** `integer`

O número máximo de usos. Sem ele, não há limite. Um uso é contado quando alguém começa a criar a partir do link; um uso recusado ou desfeito é devolvido.

**expires\_in\_days** `integer`

O número de dias até o link expirar. Sem ele, o link não expira.

```bash cURL theme={null}
curl -X POST https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
  -H "Authorization: Bearer $VERTRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "use", "max_uses": 10, "expires_in_days": 7 }'
```

### Resposta

**response** `object`

O link.

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

**token** `string`

O token completo. Mostrado uma vez.

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

### 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:write` (`403`).
* `TEMPLATE_NOT_FOUND`: O template não existe, foi excluído ou não é seu (`404`).
* `TEMPLATE_SAVE_NOT_ALLOWED`: `full_copy` foi pedido e o template não permite (`share.full_copy` não é `true`) (`403`).
* `TEMPLATE_CLOSED`: `full_copy` foi pedido para um template fechado (`403`).
* `VALIDATION_ERROR`: `max_uses` ou `expires_in_days` não é um inteiro positivo (`400`).
* `WORKSPACE_OWNER_ONLY`: Só o dono do workspace cria links dos templates dele.

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


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