curl -X PATCH https://api.vertracloud.app/v1/stacks/stk-abc123def456 \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "shop-prod" }'
{
"response": {}
}Stacks
Atualizar stack
Renomeia uma stack ou altera a descrição dela.
PATCH
/
v1
/
stacks
/
{stack_id}
curl -X PATCH https://api.vertracloud.app/v1/stacks/stk-abc123def456 \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "shop-prod" }'
{
"response": {}
}Altera o nome ou a descrição de uma stack. Pelo menos um campo é obrigatório. Precisa do escopo
stacks:write quando chamado com uma chave de API.
string
obrigatório
O ID da stack.
string
O workspace ao qual a stack pertence, quando você age sobre ela como dono do workspace.
string
O novo nome.
string | null
A nova descrição.
null a remove.Resposta
object
A stack atualizada, com os mesmos campos de Obter stack.
curl -X PATCH https://api.vertracloud.app/v1/stacks/stk-abc123def456 \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "shop-prod" }'
Erros
| Status | Código | Quando |
|---|---|---|
| 400 | VALIDATION_ERROR | Nenhum campo foi enviado, ou um valor é inválido. |
| 403 | WORKSPACE_OWNER_ONLY | Você é membro do workspace, não o dono. |
| 404 | STACK_NOT_FOUND | A stack não existe ou pertence a outra conta. |
Última modificação em 28 de outubro de 2026