Skip to content

Instances API

Create, list, restart, and inspect tenant Odoo instances programmatically.

1. List Instances

Request

curl -s -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://jengastack.app/api/v1/instances/

Response (200 OK)

{
  "instances": [
    {
      "id": "inst_01j4k9",
      "subdomain": "nairobi-retail",
      "domain": "nairobi-retail.jengastack.app",
      "status": "RUNNING",
      "plan": "growth",
      "cpu_usage_pct": 14.2,
      "memory_usage_mb": 1420,
      "created_at": "2026-08-01T10:00:00Z"
    }
  ]
}

2. Restart Instance

Request

curl -X POST -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://jengastack.app/api/v1/instances/inst_01j4k9/restart/

Response (202 Accepted)

{
  "status": "RESTARTING",
  "message": "Instance restart initiated."
}