---
title: "Pause a progressive rollout"
method: POST
path: "/api/v2/feature-flags/exposure-schedules/{exposure_schedule_id}/pause"
tags: ["Feature Flags"]
---

# Pause a progressive rollout

`POST /api/v2/feature-flags/exposure-schedules/{exposure_schedule_id}/pause`

Pauses a progressive rollout while preserving rollout state.

## Path parameters

- `exposure_schedule_id` string, uuid, required

## Response `200`

OK

- AllocationExposureScheduleResponse — Response containing a progressive rollout schedule.
  - `data` AllocationExposureScheduleData, required — Data wrapper for progressive rollout schedule responses.
    - `attributes` AllocationExposureSchedule, required — Progressive release details for a targeting rule allocation.
      - `absolute_start_time` string, date-time, nullable — The absolute UTC start time for this schedule.
      - `allocation_id` string, uuid, required — The targeting rule allocation ID this progressive rollout belongs to.
      - `control_variant_id` string, nullable — The control variant ID used for experiment comparisons.
      - `created_at` string, date-time, required — The timestamp when the schedule was created.
      - `guardrail_triggered_action` string, nullable — Last guardrail action triggered for this schedule.
      - `guardrail_triggers` AllocationExposureGuardrailTrigger[], required — Guardrail trigger records for this schedule.
        - `allocation_exposure_schedule_id` string, uuid, required — The progressive rollout ID this trigger belongs to.
        - `created_at` string, date-time, required — The timestamp when this trigger was created.
        - `flagging_variant_id` string, uuid, required — The variant ID that triggered this event.
        - `id` string, uuid, required — The unique identifier of the guardrail trigger.
        - `metric_id` string, required — The metric ID associated with the trigger.
        - `triggered_action` string, required — The action that was triggered.
        - `updated_at` string, date-time, required — The timestamp when this trigger was last updated.
      - `id` string, uuid — The unique identifier of the progressive rollout.
      - `rollout_options` RolloutOptions, required — Applied progression options for a progressive rollout.
        - `autostart` boolean, required — Whether the schedule starts automatically.
        - `selection_interval_ms` integer, required — Interval in milliseconds for uniform interval strategies.
        - `strategy` 'UNIFORM_INTERVALS' | 'NO_ROLLOUT', required — The progression strategy used by a progressive rollout.
      - `rollout_steps` AllocationExposureRolloutStep[], required — Ordered progression steps for exposure.
        - `allocation_exposure_schedule_id` string, uuid, required — The progressive rollout ID this step belongs to.
        - `created_at` string, date-time, required — The timestamp when the progression step was created.
        - `exposure_ratio` number, double, required — The exposure ratio for this step.
        - `grouped_step_index` integer, required — Logical index grouping related steps.
        - `id` string, uuid, required — The unique identifier of the progression step.
        - `interval_ms` integer, nullable — Step duration in milliseconds.
        - `is_pause_record` boolean, required — Whether this step represents a pause record.
        - `order_position` integer, required — Sort order for the progression step.
        - `updated_at` string, date-time, required — The timestamp when the progression step was last updated.
      - `updated_at` string, date-time, required — The timestamp when the schedule was last updated.
    - `id` string, uuid, required — The unique identifier of the progressive rollout.
    - `type` 'allocation_exposure_schedules', required — The resource type for progressive rollout schedules.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `429` — Too many requests

---

[API](https://skmtc.dev/datadog/apis/api-v2.md) · [All operations](https://skmtc.dev/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)