---
title: "Exclude the failing collectors from a halted rollout and continue it"
method: POST
path: "/api/{org_id}/fleet/rollouts/{id}/skip"
tags: ["Fleet"]
---

# Exclude the failing collectors from a halted rollout and continue it

`POST /api/{org_id}/fleet/rollouts/{id}/skip`

## 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/{id}/skip`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/fleet/rollouts/:id/skip/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required
- `id` string, required

## Request body

- SkipRequest
  - `collector_ids` string[], required

## Response `200`

The rollout

- Rollout
  - `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

## Other responses

- `400`: Invalid
- `403`: Forbidden
- `404`: Not found
- `409`: Not halted, or the halt does not offer this exit

---

[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)