GET
/
instance
/
status
/
{instanceId}
GET /instance/status/:id
curl --request GET \
  --url https://api.example.com/instance/status/{instanceId}
{
  "404": {},
  "status": "<string>",
  "uptime_seconds": 123,
  "cpu_usage_percent": 123,
  "memory_usage_mb": 123
}

​
Overview

Retrieve current status, uptime, and resource usage for an instance.

​
Request

curl https://api.agentik.dev/api/instance/status/inst_7xKXtg2CW87 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

​
Path Parameters

​
instanceId
string
required
Instance ID from /instance/create

​
Response

{
  "instance_id": "inst_7xKXtg2CW87",
  "name": "my-agent",
  "status": "running",
  "framework": "openclaw",
  "port": 18042,
  "url": "https://inst-7xKXtg2CW87.agentik.dev",
  "uptime_seconds": 3600,
  "cpu_usage_percent": 12.5,
  "memory_usage_mb": 256,
  "memory_limit_mb": 1024,
  "created_at": "2026-02-12T10:30:00Z",
  "last_activity": "2026-02-12T11:15:22Z"
}
​
status
string
Instance status: provisioning, running, stopped, failed
​
uptime_seconds
number
Seconds since instance started
​
cpu_usage_percent
number
Current CPU usage percentage
​
memory_usage_mb
number
Current memory usage in megabytes

​
Status Values

  • provisioning: Container being created (wait 10-30s)
  • running: Instance active and accessible
  • stopped: Manually stopped (data preserved)
  • failed: Provisioning or runtime error occurred

​
Errors

​
404
error
Instance not found or not owned by user