List the releases running now

GET /ops/releases/current

More than one during a rolling deploy. An instance counts as running until it stops or misses three heartbeats.

Authorization

bearer

Authorizationheader · stringrequired

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

Responses

errors: application/problem+json

200

401

Unauthorized

403

Forbidden

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

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/current" \
  -H "Authorization: Bearer $TOKEN"

req, err := http.NewRequestWithContext(ctx, http.MethodGet,
	apiURL + "/ops/releases/current", 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/current`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
  },
});
const data = await res.json();

Responseexample

{
  "releases": [
    {
      "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"
        }
      ],
      "version": "v1.4.0",
      "commit": "3f9a1c2b7d4e8a90"
    }
  ]
}

{
  "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"
}