curl -X DELETE https://api.vertracloud.app/v1/templates/tpl-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": null
}
Templates
Excluir um template privado
Exclui um template privado e revoga todos os seus links de compartilhamento. O que já foi criado a partir dele continua em execução.
DELETE
/
v1
/
templates
/
{template_id}
curl -X DELETE https://api.vertracloud.app/v1/templates/tpl-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": null
}
Esta chamada exclui um template privado. Os links de compartilhamento dele deixam de funcionar imediatamente, o slug fica livre e ele deixa de contar no seu limite de 5 templates privados. Aplicações e stacks já criados a partir dele continuam em execução e são informados de que o template foi removido; eles não recebem mais atualizações. As cópias que outras pessoas fizeram por um link de cópia completa são independentes e não são afetadas.
Precisa do escopo
templates:write quando chamada com uma chave de API. Só o dono do template pode excluí-lo; se ele estiver em um workspace, quem pode excluir é o dono do workspace. Um template do catálogo ou de outra conta responde 404, como se não existisse. Uma imagem que é a origem da versão atual de um template privado não pode ser excluída antes do template (IMAGE_IN_USE).
string
obrigatório
O ID do template.
string
Se o template pertencer a um workspace, o ID do workspace.
curl -X DELETE https://api.vertracloud.app/v1/templates/tpl-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY"
Resposta
null
Sempre
null.{
"response": null
}
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, já foi excluído ou não é seu (404).WORKSPACE_OWNER_ONLY: Só o dono do workspace exclui os templates do workspace.
{
"code": "TEMPLATE_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026