curl -X DELETE https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links/lnk-abc123def456 \
-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": null,
"revoked_at": "2026-10-27T16:00:00Z",
"created_at": "2026-10-27T14:02:00Z"
}
}
Links de compartilhamento
Revogar um link de compartilhamento
Revoga um link de compartilhamento de um template privado para que ninguém mais o use, sem afetar o que já foi criado a partir dele.
DELETE
/
v1
/
templates
/
{template_id}
/
share-links
/
{link_id}
curl -X DELETE https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links/lnk-abc123def456 \
-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": null,
"revoked_at": "2026-10-27T16:00:00Z",
"created_at": "2026-10-27T14:02:00Z"
}
}
Esta chamada revoga um link de compartilhamento: ele não aceita mais novos usos e deixa de oferecer atualizações ao que foi criado a partir dele. Aplicações e stacks já criados a partir do link continuam em execução, e as cópias já feitas continuam com os seus donos. Revogar é idempotente: revogar um link já revogado responde com o link como ele está.
Precisa do escopo
templates:write quando chamada com uma chave de API. Só o dono do template pode revogar os links dele.
string
obrigatório
O ID do template.
string
obrigatório
O ID do link.
string
Se o template pertencer a um workspace, o ID do workspace.
curl -X DELETE https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links/lnk-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY"
Resposta
object
O link, com
revoked_at preenchido.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": null,
"revoked_at": "2026-10-27T16:00:00Z",
"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:write(403).TEMPLATE_NOT_FOUND: O template não existe ou não é seu (404).SHARE_LINK_NOT_FOUND: O link não existe nesse template (404).WORKSPACE_OWNER_ONLY: Só o dono do workspace revoga os links dos templates dele.
{
"code": "SHARE_LINK_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026