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
Update Stack
Renames a stack or changes its description.
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": {}
}Changes the name or the description of a stack. At least one field is required. Needs the
stacks:write scope when called with an API key.
string
required
The stack ID.
string
The workspace the stack belongs to, when you act on it as the workspace owner.
string
The new name.
string | null
The new description.
null removes it.Response
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" }'
Errors
| Status | Code | When |
|---|---|---|
| 400 | VALIDATION_ERROR | No field was sent, or a value is invalid. |
| 403 | WORKSPACE_OWNER_ONLY | You are a workspace member, not the owner. |
| 404 | STACK_NOT_FOUND | The stack does not exist or belongs to another account. |
Last modified on October 28, 2026