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

# Visualizar um link de compartilhamento de template

> Mostra o que um link de compartilhamento de template cria antes de alguém usá-lo: serviços, memória, plano, perguntas e permissões.

Esta chamada retorna o que um link de compartilhamento criaria, para que a pessoa possa decidir antes de usá-lo. Ela funciona sem autenticação; quando você está autenticado, a resposta também traz um objeto `account` que informa se o template cabe na sua conta. Ela é limitada por IP (20 requisições por minuto).

A prévia nunca mostra IDs, e-mails, o manifesto ou o código-fonte. `verified` é sempre `false`: a Vertra Cloud não revisa templates privados, e o painel mostra "Não verificado pela Vertra" ao lado de cada um. Confira o autor e o que o template faz antes de usá-lo. Em um template fechado (`code_view` é `false`), você não pode ver o código, e os valores que preencher vão para um código que você não consegue ler. Se algo parecer errado, [denuncie o template](https://docs.vertracloud.app/pt-br/api-reference/endpoint/templates/share-links/report.md).

Uma chave de API precisa do escopo `templates:read` quando é enviada.

**token** `string` *required*

O token do link, que começa com `vtpl_`.

```bash cURL theme={null}
curl https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN
```

### Resposta

**response** `object`

A prévia.

**Mostrar objeto**

**mode** `string`

`use` (você cria as próprias aplicações a partir dele) ou `full_copy` (você recebe um template privado próprio).

**name** `object`

O nome do template por idioma (`pt-br`, `en`, `es`).

**description** `object`

A descrição por idioma.

**category** `string`

A categoria.

**icon\_url** `string | null`

URL do ícone, ou `null`.

**author\_display** `string | null`

O nome que o autor escolheu exibir.

**version** `string`

A versão que o link fornece.

**services** `object[]`

O que seria criado. Cada serviço tem `id`, `kind` (`app`, `database` ou `blob`), `source_type`, `database`, `blob_visibility`, `ram` (`min`, `recommended`, `max` opcional, em MB), `web` e `conditional`.

**creates\_stack** `boolean`

`true` quando cria uma stack.

**ram\_min\_total** `integer`

A soma da memória mínima dos serviços, em MB.

**required\_plan** `string`

O plano mais baixo que pode usá-lo.

**image\_slots\_needed** `integer`

As vagas de imagem personalizada que você usaria: uma por imagem distinta do template, então pode ser mais de 1. Um template só com código não usa nenhuma.

**verified** `boolean`

Sempre `false`.

**code\_view** `boolean`

`false` para um [template fechado](https://docs.vertracloud.app/pt-br/templates/use/closed-templates.md).

**byok** `boolean`

`true` quando você traz a sua própria chave para um modelo de IA.

**inputs** `object[]`

As perguntas que você responde ao usá-lo.

**permissions** `object`

O que você pode fazer com as aplicações criadas a partir dele: `code_view`, `code_edit`, `ram_change`, `ram_below_min`, `ram_above_max`, `env_add`, `commands_edit`, `terminal`, `save_as_template` e `detach`.

**account** `object`

Só quando autenticado: `fits`, `reasons`, `required_ram`, `free_ram`, `needs_image_slot`, `image_slots_free`, `in_use` e `in_use_count`.

```json Response theme={null}
{
  "response": {
    "mode": "use",
    "name": { "pt-br": "Bot de suporte", "en": "Support bot" },
    "description": { "pt-br": "Bot que responde o suporte." },
    "category": "bots",
    "icon_url": null,
    "author_display": "Ana",
    "version": "1.0.0",
    "services": [
      { "id": "bot", "kind": "app", "source_type": "code", "database": null, "blob_visibility": null, "ram": { "min": 256, "recommended": 512 }, "web": "none", "conditional": false }
    ],
    "creates_stack": false,
    "ram_min_total": 256,
    "required_plan": "economy",
    "image_slots_needed": 0,
    "verified": false,
    "code_view": true,
    "byok": false,
    "inputs": [],
    "permissions": {
      "code_view": true,
      "code_edit": true,
      "ram_change": true,
      "ram_below_min": false,
      "ram_above_max": true,
      "env_add": true,
      "commands_edit": true,
      "terminal": false,
      "save_as_template": false,
      "detach": true
    }
  }
}
```

### Respostas de erro

**code** `string`

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

* `SHARE_LINK_NOT_FOUND`: O token tem formato inválido, não existe, ou o template foi excluído (`404`).
* `SHARE_LINK_REVOKED`: O autor revogou o link (`410`).
* `SHARE_LINK_EXPIRED`: O link passou do seu `expires_at` (`410`).
* `SHARE_LINK_EXHAUSTED`: O link atingiu o seu `max_uses` (`410`).
* `API_KEY_SCOPE_DENIED`: Uma chave de API foi enviada sem o escopo `templates:read` (`403`).

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


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