Status da aplicação
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/status"
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/{id}/status"
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": {
"id": "app-abc123def456",
"cpu": "25.50%",
"ram": "512.00 MB",
"storage": "1024.00 MB",
"status": "running",
"running": true,
"network": {
"total": "569.90KB ↓ 36.41KB ↑",
"now": "18.78KB ↑ 1.20KB ↓"
},
"uptime": 3600
}
}
Aplicações
Status da aplicação
Retorna o status atual e o uso de recursos de uma aplicação pelo seu ID.
GET
/
v1
/
apps
/
{id}
/
status
Status da aplicação
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/status"
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/{id}/status"
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": {
"id": "app-abc123def456",
"cpu": "25.50%",
"ram": "512.00 MB",
"storage": "1024.00 MB",
"status": "running",
"running": true,
"network": {
"total": "569.90KB ↓ 36.41KB ↑",
"now": "18.78KB ↑ 1.20KB ↓"
},
"uptime": 3600
}
}
string
obrigatório
O ID da aplicação cujo status será retornado. Se a aplicação pertencer a um workspace, informe o ID dele no query parameter
workspace_id.string
Se a aplicação pertencer a um workspace, o ID do workspace. Obrigatório para membros do workspace que agem sobre uma aplicação que não lhes pertence.
Uma aplicação parada responde
200, e não um erro. O container de uma aplicação parada não existe — ele é removido ao parar — e isso é um estado normal, não uma falha. A API retorna 200 com running: false e todas as métricas zeradas. Só uma falha real na leitura do status retorna 500.Resposta
object
O status da aplicação e os detalhes de uso de recursos.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O ID da aplicação.
string
Porcentagem de uso de CPU (por exemplo,
25.5%).string
Uso de RAM (por exemplo,
512 MB).string
Uso de armazenamento (por exemplo,
1024 MB).string
O status da aplicação (por exemplo,
running).boolean
Indica se a aplicação está em execução.
boolean
Presente e
true enquanto as dependências estão sendo instaladas ou a aplicação está sendo rebuildada. Durante esse tempo, running pode ser false mesmo com trabalho em andamento. Trate isso como um estado em progresso, não como “parada”, e não emita um start enquanto ele for true. Um restart com reinstall_dependencies ou force_build é uma das operações que abrem esta janela.object
number
O tempo em que a aplicação está no ar, em segundos.
{
"response": {
"id": "app-abc123def456",
"cpu": "25.50%",
"ram": "512.00 MB",
"storage": "1024.00 MB",
"status": "running",
"running": true,
"network": {
"total": "569.90KB ↓ 36.41KB ↑",
"now": "18.78KB ↑ 1.20KB ↓"
},
"uptime": 3600
}
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: o headerAuthorizationestá 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 é usada a partir de um IP fora da sua allowlist, 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).APP_NOT_FOUND: a aplicação informada não existe.FORBIDDEN: o usuário não tem permissão para acessar a aplicação.INTERNAL_SERVER_ERROR: o status não pôde ser lido. Uma aplicação parada não é este caso — veja a nota acima.
string
Uma mensagem descritiva com detalhes adicionais sobre o erro.
{
"code": "APP_NOT_FOUND"
}
{
"code": "FORBIDDEN"
}
{
"code": "INTERNAL_SERVER_ERROR"
}
Última modificação em 28 de outubro de 2026