curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"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"
}
]
}
Links de compartilhamento
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.
GET
/
v1
/
templates
/
{template_id}
/
share-links
curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"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"
}
]
}
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.
string
obrigatório
O ID do template.
string
Se o template pertencer a um workspace, o ID do workspace.
curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
-H "Authorization: Bearer $VERTRA_API_KEY"
Resposta
object[]
Os links.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O ID do link.
string
O template ao qual o link pertence.
string
use ou full_copy.string
Os últimos 4 caracteres do token, para diferenciar os links.
integer
Quantas vezes o link foi usado.
integer | null
O número máximo de usos, ou
null para sem limite.string | null
Quando o link expira, ou
null quando não expira.string | null
Quando o autor revogou o link, ou
null.string
Quando o link foi criado.
{
"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
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 escopotemplates: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.
{
"code": "TEMPLATE_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026