Vincular template ou stack
curl --request POST \
--url https://api.vertracloud.app/v1/workspaces/{id}/templates/{template_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/workspaces/{id}/templates/{template_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/workspaces/{id}/templates/{template_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/workspaces/{id}/templates/{template_id}"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}Aplicações e bancos
Vincular template ou stack
Move um template privado, ou uma stack, da sua conta para um workspace. Somente o dono. Também disponível em /stacks/.
POST
/
v1
/
workspaces
/
{id}
/
templates
/
{template_id}
Vincular template ou stack
curl --request POST \
--url https://api.vertracloud.app/v1/workspaces/{id}/templates/{template_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/workspaces/{id}/templates/{template_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/workspaces/{id}/templates/{template_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/workspaces/{id}/templates/{template_id}"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}Move um dos seus templates privados para o workspace. As mesmas regras valem para uma stack em
POST https://api.vertracloud.app/v1/workspaces/{id}/stacks/{stack_id}; uma stack só é movida quando
todos os seus membros já estão no workspace. Mesmas regras de Vincular aplicação:
somente o dono, escopo workspaces:write para uma chave de API, e o recurso precisa pertencer a quem chama.
Caminho
string
obrigatório
ID do workspace.
string
obrigatório
ID do template. Para uma stack, use
/stacks/{stack_id} com o ID da stack.Resposta
Resposta vazia em caso de sucesso.Erros
| Status | Código | Quando |
|---|---|---|
| 403 | WORKSPACE_OWNER_ONLY | Quem chama não é o dono do workspace. |
| 403 | PLAN_RESTRICTED_FEATURE | O plano do dono está congelado. |
| 404 | WORKSPACE_NOT_FOUND | O workspace não existe ou você não é membro. |
| 404 | TEMPLATE_NOT_FOUND | O template não existe ou não pertence a quem chama. |
| 404 | STACK_NOT_FOUND | A stack não existe ou não pertence a quem chama. |
| 409 | STACK_MEMBER_CONFLICT | Um membro da stack não está no workspace. |
Última modificação em 28 de outubro de 2026