Obter URL do webhook de deploy
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook"
req, _ := http.NewRequest("GET", 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))
}{
"response": {
"repo_owner": "owner_name",
"repo_name": "repository_name",
"webhook_url": "https://api.vertracloud.app/v1/apps/123/deploys/receiver/webhook",
"branch": "develop"
}
}
Deploys
Obter URL do webhook de deploy
Retorna a URL do webhook de deploy do GitHub e as informações do repositório de uma aplicação.
GET
/
v1
/
apps
/
{app_id}
/
deploys
/
webhook
Obter URL do webhook de deploy
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook"
req, _ := http.NewRequest("GET", 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))
}{
"response": {
"repo_owner": "owner_name",
"repo_name": "repository_name",
"webhook_url": "https://api.vertracloud.app/v1/apps/123/deploys/receiver/webhook",
"branch": "develop"
}
}
string
obrigatório
O ID da aplicação cuja URL do webhook será retornada.
Resposta
object
{
"response": {
"repo_owner": "owner_name",
"repo_name": "repository_name",
"webhook_url": "https://api.vertracloud.app/v1/apps/123/deploys/receiver/webhook",
"branch": "develop"
}
}
Respostas de erro
string
Códigos de erro possíveis:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: o cabeçalhoAuthorizationestá ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: a chave de API está sendo usada a partir de um IP fora da sua lista de permissões, ou não tem o escopo que a rota exige (403).ACCESS_DENIED: o recurso pertence a outra conta, ou você não tem a permissão do workspace para ele (403).PLAN_RESTRICTED_FEATURE: o plano do usuário não oferece suporte a deploy automático.DEPLOYMENT_NOT_FOUND: webhook de integração não encontrado para a aplicação.
string
Uma mensagem descritiva com detalhes adicionais sobre o erro.
{
"code": "DEPLOYMENT_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026