---
title: "List the org's rollouts, or one fleet's, newest first"
method: GET
path: "/api/{org_id}/fleet/rollouts"
tags: ["Fleet"]
---

# List the org's rollouts, or one fleet's, newest first

`GET /api/{org_id}/fleet/rollouts`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/fleet/rollouts`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/fleet/rollouts/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Query parameters

- `fleet` string
- `offset` integer
- `limit` integer

## Response `200`

Success

- RolloutList
  - `items` Rollout[], required
    - `auto_rollback` boolean, required
    - `batching` union, required: Phase sizes are counts of collectors, never percentages.
      - object
        - `kind` 'one', required
      - object
        - `first` integer, required
        - `kind` 'canary', required
      - object
        - `initial` integer, required
        - `kind` 'progressive', required
        - `max` integer, required
        - `multiplier` integer, required
    - `config` string, required
    - `ended_at` integer, nullable: Epoch milliseconds.
    - `events` RolloutEvent[], required
      - `at` integer, required: Epoch milliseconds.
      - `detail` string, nullable
      - `key` string, required
      - `phase` integer, nullable
    - `fleet` CollectorFleet, required: A fleet named by its public id; `name` is null once the fleet was deleted.
      - `id` string, required
      - `name` string, nullable
    - `from_version` integer, nullable
    - `halt` RolloutHalt
      - `at` integer, required: Epoch milliseconds.
      - `class` 'proven_bad' | 'looks_worse' | 'cannot_see', required: The evidence class of a halt; only the first two may roll back automatically.
      - `exits` HaltExit[], required
      - `reason` string, required
    - `id` string, required
    - `members` RolloutMember[], required
      - `collector_id` string, required
      - `evidence` DeliveryEvidence: The facts the delivery state is derived from.
        - `last_heartbeat_at` integer, nullable: Epoch milliseconds.
        - `marker` FleetVersion: A configuration version a fleet runs or should run.
          - `config` string, required
          - `version` integer, required
        - `remote_at` integer, nullable: Epoch milliseconds.
        - `remote_hash` string, nullable: Hex of the last `RemoteConfigStatus` hash.
        - `remote_status` string, nullable: The last `RemoteConfigStatus` status, e.g. `APPLIED` or `FAILED`.
      - `excluded` boolean, required: Skipped after a halt; included again by default in the next rollout.
      - `phase` integer, required
      - `state` 'pending' | 'assigned' | 'sent' | 'accepted' | 'running' | 'rejected' | 'removed', required
    - `phases` RolloutPhase[], required
      - `confirmed` integer, required
      - `gate` GateResult
        - `observed` string, required
        - `passed` boolean, required
      - `index` integer, required
      - `rejected` integer, required
      - `sent` integer, required
      - `size` integer, required
      - `status` 'pending' | 'deploying' | 'converging' | 'observing' | 'verifying' | 'done' | 'failed' | 'stopped' | 'timed_out', required
      - `targeted` integer, required
    - `running` integer, required: Members running the new version.
    - `start` union, required
      - object
        - `kind` 'now', required
      - object: Epoch milliseconds.
        - `at` integer, required
        - `kind` 'at', required
    - `started_at` integer, required: Epoch milliseconds.
    - `started_by` string, required
    - `status` 'scheduled' | 'waiting' | 'in_progress' | 'halted' | 'completed' | 'superseded' | 'rolled_back', required
    - `to_version` integer, required
    - `total` integer, required: Members fixed at creation, so the denominator never changes.
    - `verify` boolean, required
  - `total` integer, required

## Other responses

- `403`: Forbidden

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)