Skip to main content
GET
/
v1
/
apps
/
{id}
/
status
Application Status
curl --request GET \
  --url https://api.vertracloud.app/v1/apps/{id}/status
{
  "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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt

Use this file to discover all available pages before exploring further.

​
id
string
required
The application ID to retrieve the status. If the application belongs to a workspace, include the workspace ID in the format appId-workspaceId.

​
Response

​
response
object
The application status and resource usage details.
{
  "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
  }
}

​
Error Responses

​
code
string
The error code indicating the reason for the failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated or does not have sufficient permissions.
  • APP_NOT_FOUND: The specified application does not exist.
  • FORBIDDEN: The user does not have permission to access the application.
  • INTERNAL_SERVER_ERROR: Ocorreu um erro ao recuperar o status.
​
message
string
A descriptive message providing additional details about the error.
{
  "code": "APP_NOT_FOUND"
}