List instance starts, newest first

GET /ops/releases/instances

Authorization

bearer

Authorizationheader · stringrequired

Session token from POST /v1/auth/login with "transport": "bearer". Browsers use the session cookie that login sets instead.

Query

versionstring

maxLength: 100

commitstring

maxLength: 64

runningboolean

Only instances running now

limitinteger

format: int64default: 50minimum: 1maximum: 100

cursorstring

next_cursor from the previous page

maxLength: 30

Responses

errors: application/problem+json

200

400

Bad Request

401

Unauthorized

403

Forbidden

422

Unprocessable Entity

500

Internal Server Error

Match errors on the problem's code, which stays the same, not on its message.

Send a request

Server

Bearer token

version query

commit query

running query

limit query

cursor query

The request goes from your browser straight to this server; nothing passes through this site. The API must allow this site's origin for CORS.

Requestexample

curl "$API_URL/ops/releases/instances" \
  -H "Authorization: Bearer $TOKEN"

req, err := http.NewRequestWithContext(ctx, http.MethodGet,
	apiURL + "/ops/releases/instances", nil)
if err != nil {
	return err
}
req.Header.Set("Authorization", "Bearer "+token)
res, err := http.DefaultClient.Do(req)
if err != nil {
	return err
}
defer res.Body.Close()

const res = await fetch(`${apiUrl}/ops/releases/instances`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
  },
});
const data = await res.json();

Responseexample

{
  "instances": [
    {
      "id": 0,
      "instance_id": "string",
      "last_seen_at": "2026-09-15T12:00:00Z",
      "modified": false,
      "running": false,
      "started_at": "2026-09-15T12:00:00Z",
      "version": "v1.4.0",
      "build_time": "2026-09-15T12:00:00Z",
      "commit": "3f9a1c2b7d4e8a90",
      "go_version": "go1.26.1",
      "host": "acme-api-7d9f8-x2kq",
      "stopped_at": "2026-09-15T12:00:00Z"
    }
  ],
  "next_cursor": "string"
}

{
  "code": "string",
  "status": 400,
  "title": "Bad Request",
  "detail": "string",
  "request_id": "req_9f86d081884c7d65",
  "type": "string"
}

{
  "code": "string",
  "status": 401,
  "title": "Unauthorized",
  "detail": "string",
  "request_id": "req_9f86d081884c7d65",
  "type": "string"
}

{
  "code": "string",
  "status": 403,
  "title": "Forbidden",
  "detail": "string",
  "request_id": "req_9f86d081884c7d65",
  "type": "string"
}

{
  "code": "string",
  "status": 422,
  "title": "Unprocessable Entity",
  "detail": "string",
  "errors": [
    {
      "message": "expected length >= 1",
      "location": "body.name"
    }
  ],
  "request_id": "req_9f86d081884c7d65",
  "type": "string"
}