GET /api/v1/instances
List Instances
Auth: Authorization: Bearer <token> required
Request
Section titled “Request”curl -sS -X GET "https://entherium.duckdns.org:8443/api/v1/instances" \ -H "Authorization: Bearer <token>"Response 200
Section titled “Response 200”The contract carries no example for this response; schema: array of HugoInstanceRead. Field-level shape: interactive explorer.
Returns
Section titled “Returns”array of HugoInstanceRead — Successful Response
| Field | Type | Description |
|---|---|---|
attached_sc | integer | null (opt.) | |
backend | "gcs" | "local-fs" | "wp" (opt.) | |
base_url | string | null (opt.) | |
caption | string | null (opt.) | |
createtime | string | |
gcs_bucket | string | null (opt.) | |
guid | integer | |
hostname | string | null (opt.) | |
instance_id | string | |
is_active | boolean (opt.) | |
last_build_at | string | null | |
last_publish_at | string | null | |
owner | integer | null (opt.) | |
posts_count | integer | |
registry | object (opt.) | |
rsid | integer | |
template_dir | string | null (opt.) | |
theme_repo | string | null (opt.) | |
theme_sha | string | null (opt.) | |
tier | "prod" | "dev" | "test" | "staging" (opt.) | |
updatedby | integer | null (opt.) | |
updatetime | string | |
vps_ip | string | null (opt.) | |
vps_port | integer | null (opt.) | |
warmup_state | "cold" | "warming" | "warm" |
Parameters
Section titled “Parameters”None.
Errors
Section titled “Errors”| Code | Meaning | Body |
|---|---|---|
401 | Missing or invalid authentication credentials | ErrorResponse |
Every error body is {detail, code?, request_id, doc_url} — request_id is the value to quote, doc_url points at the Errors reference.