curl -X POST https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN/report \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "reason": "leaked_secret", "details": "The code has a token in src/config.js" }'
{
"response": null
}
Links de compartilhamento
Denunciar um template
Denuncia um template privado à Vertra Cloud pelo seu link de compartilhamento ou por uma aplicação criada a partir dele, com um motivo e detalhes opcionais.
POST
/
v1
/
share
/
templates
/
{token}
/
report
curl -X POST https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN/report \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "reason": "leaked_secret", "details": "The code has a token in src/config.js" }'
{
"response": null
}
Esta chamada denuncia um template privado à Vertra Cloud e responde
200 com null. O autor não é informado de quem denunciou. As denúncias são analisadas pela plataforma; em um caso grave, com evidências, escreva também para [email protected].
São duas rotas com o mesmo corpo: POST /v1/share/templates/{token}/report a partir de um link de compartilhamento, que continua funcionando mesmo depois de o link ser revogado, e POST /v1/apps/{id}/template/report a partir de uma aplicação criada a partir do template. Na rota da aplicação, quem chama é o dono da aplicação ou, em um workspace, um membro com acesso às aplicações. Uma conta pode denunciar o mesmo template no máximo 3 vezes; depois disso, a chamada falha com 429.
As duas precisam do escopo templates:write quando chamadas com uma chave de API. Os detalhes nunca são gravados em logs.
string
obrigatório
O token do link, na rota do link.
string
obrigatório
O ID da aplicação, na rota da aplicação.
string
Na rota da aplicação, o ID do workspace quando a aplicação pertencer a um.
string
obrigatório
malware, scam, copyright, leaked_secret ou other.string
O que você viu, até 1.000 caracteres.
curl -X POST https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN/report \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "reason": "leaked_secret", "details": "The code has a token in src/config.js" }'
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).VALIDATION_ERROR:reasonnão é um dos valores acima, oudetailstem mais de 1.000 caracteres (400).SHARE_LINK_NOT_FOUND: O token tem formato inválido, não existe, ou o template foi excluído (404).APP_NOT_FOUND: Na rota da aplicação, a aplicação não existe ou não é sua.TEMPLATE_NOT_FOUND: Na rota da aplicação, a aplicação não veio de um template (404).RATE_LIMIT_EXCEEDED: Você já denunciou este template 3 vezes (429).
{
"code": "SHARE_LINK_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026