List releases, newest first

GET /ops/releases

Every version and commit an instance has run, with how many instances run it now.

Authorization

bearer

Authorizationheader · stringrequired

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

Query

limitinteger

format: int64default: 50minimum: 1maximum: 100

cursorstring

next_cursor from the previous page

maxLength: 512

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

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

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

Responseexample

{
  "releases": [
    {
      "first_started_at": "2026-09-15T12:00:00Z",
      "last_seen_at": "2026-09-15T12:00:00Z",
      "modified": false,
      "running": 0,
      "starts": 0,
      "version": "v1.4.0",
      "commit": "3f9a1c2b7d4e8a90"
    }
  ],
  "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"
}