Estado de la aplicación
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
}
}
Aplicaciones
Estado de la aplicación
Devuelve el estado actual y el uso de recursos de una aplicación a partir de su ID.
GET
/
v1
/
apps
/
{id}
/
status
Estado de la aplicación
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
requerido
El ID de la aplicación cuyo estado quieres obtener. Si la aplicación pertenece a un workspace, pasa su ID en el parámetro de consulta
workspace_id.string
Si la aplicación pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúen sobre una aplicación que no les pertenece.
Una aplicación detenida responde
200, no un error. El contenedor de una aplicación detenida no existe: se elimina al detenerla, y eso es un estado normal, no un fallo. La API devuelve 200 con running: false y todas las métricas a cero. Solo un fallo real al leer el estado devuelve 500.Respuesta
object
El estado de la aplicación y el detalle de uso de recursos.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID de la aplicación.
string
Porcentaje de uso de CPU (por ejemplo,
25.5%).string
Uso de RAM (por ejemplo,
512 MB).string
Uso de almacenamiento (por ejemplo,
1024 MB).string
El estado de la aplicación (por ejemplo,
running).boolean
Indica si la aplicación está en ejecución.
boolean
Presente y
true mientras se instalan las dependencias o la aplicación se reconstruye. Durante este tiempo, running puede ser false aunque haya trabajo en curso. Trátalo como un estado en progreso, no como “detenida”, y no envíes un start mientras sea true. Un reinicio con reinstall_dependencies o force_build es una de las operaciones que abre esta ventana.object
number
El tiempo de actividad de la aplicación, en 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
}
}
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: Falta la cabeceraAuthorization, la clave de API no es válida o la sesión del panel fue revocada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (403).ACCESS_DENIED: El recurso pertenece a otra cuenta, o no tienes el permiso de workspace necesario para él (403).APP_NOT_FOUND: La aplicación indicada no existe.FORBIDDEN: El usuario no tiene permiso para acceder a la aplicación.INTERNAL_SERVER_ERROR: No se pudo leer el estado. Una aplicación detenida no es este caso; consulta la nota de arriba.
string
Un mensaje descriptivo con más detalles sobre el error.
{
"code": "APP_NOT_FOUND"
}
{
"code": "FORBIDDEN"
}
{
"code": "INTERNAL_SERVER_ERROR"
}
Última modificación el 28 de octubre de 2026