# Revert update to draft

URL: /en/docs/api/v1/updates/id/revert-to-draft/post
Last Updated: 2026-07-30T21:15:30.702Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/updates/{id}/revert-to-draft

**Revert update to draft**

Return a published, scheduled, or archived update to draft when it has not sent email delivery. Published updates with email channels cannot be reverted because customers may already have received them. Request bodies must be empty; lifecycle fields are rejected on this endpoint.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | Yes | Update ID |

**Request body** (`application/json`) - required:

Example (revert):

```json
{}
```

**Responses:**

- `200` - Update returned to draft
  - `success` (boolean)
  - `data` (object)
    - `update` (Update (object))
      - `id` (string)
      - `title` (string)
      - `slug` (any): URL-safe identifier used by Trust Center update modal links.
      - `summary` (any)
      - `description_md` (any): Markdown body shown in the Trust Center update modal or timeline.
      - `status` (enum: draft | scheduled | published | archived)
      - `classification` (object)
        - `id` (string)
        - `title` (string)
        - `color` (any)
        - `translations` (array of ClassificationTranslation (object))
          - `languages_code` (string)
          - `title` (string)
        - `custom_fields` (array of ClassificationCustomField (object))
          - `title` (string)
          - `translations` (array of ClassificationTranslation (object))
            - `languages_code` (string)
            - `title` (string)
          - `options` (array of object)
            - `value` (string)
            - `label` (array of object)
              - `languages_code` (string)
              - `translation` (string)
      - `access_level` (AccessLevel (enum: public | restricted | requires_nda | internal))
      - `send_mode` (enum: none | immediate | scheduled)
      - `channels` (array of UpdateChannel (enum: trust_center | email.subscribers | email.custom))
      - `scheduled_at` (any)
      - `scheduled_timezone` (any)
      - `published_at` (any)
      - `effective_at` (any)
      - `effective_timezone` (any)
      - `order` (enum: asc | desc)
      - `parent` (object)
        - `id` (string)
        - `title` (string)
      - `template` (object)
        - `id` (string)
        - `title` (string)
        - `summary` (any)
        - `description_md` (any)
        - `badge` (any)
        - `tenant` (any)
        - `category` (object)
          - `id` (string)
          - `title` (string)
      - `documents` (array of UpdateDocumentRelation (object))
        - `id` (string)
        - `documents_id` (object)
          - `id` (string)
          - `title` (string)
      - `subprocessors` (array of UpdateSubprocessorRelation (object))
        - `id` (string)
        - `subprocessors_id` (object)
          - `id` (string)
          - `title` (string)
- `400` - Update cannot be reverted to draft
- `404` - Update not found