---
title: "Create controlled rollback draft"
method: POST
path: "/controlled-action/rollback-draft"
---

# Create controlled rollback draft

`POST /controlled-action/rollback-draft`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/controlled-action/rollback-draft`
- Auth: HTTP bearer

Creates a compensating controlled action draft from a rollback plan. Approval and execute are still separate.

## Request body

- object
  - `action_id` string, required
  - `request_id` string, required
  - `requested_by` string
  - `confirmation` string
  - `internal_override` boolean
  - `audit_context` object

## Response `200`

Rollback draft

- object
  - `schema_version` string
  - `status` string, required
  - `action_id` string
  - `request_id` string
  - `controlled_action` object
  - `authority_flags` object
    - `platform_write_allowed` boolean
  - `result` object
  - `rollback_of_action_id` string
  - `rollback_boundary` object
    - `contract_schema_version` 'gravityads.controlled_rollback_boundary.v1', required
    - `phase_contract` 'phase2_rollback_draft_never_auto_executes', required
    - `stage` 'plan' | 'draft', required
    - `action_id_hash` string
    - `request_id_hash` string
    - `request_thread_platform_write_called` false, required
    - `platform_write_called` false, required
    - `rollback_plan_only` boolean
    - `rollback_draft_only` boolean
    - `draft_required_before_execute` boolean
    - `approval_required_before_execute` true, required
    - `execute_required_for_platform_write` true, required
    - `worker_required_for_hosted_live_write` boolean
    - `raw_platform_response_returned` false, required
    - `raw_customer_ids_returned` false, required

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)