---
title: Edit
description: Convert a pull request to or from a draft.
---

The `edit` action lets Mergify change a pull request's draft state. This is
helpful when you want to automatically convert a pull request to or from a draft
based on its conditions.

## Parameters

| Key name | Value type | Default | Description |
| --- | --- | --- | --- |
| `bot_account` | `{{ author }}` or string or null | `null` |  |
| `draft` | boolean or null | `null` | If the pull request should be a draft (true) or the other way around (false). |

## Examples

### Converting a Pull Request to a Draft on Check Failure

If any of your continuous integration checks fail, it might be worth converting
the pull request to a draft automatically since it's likely that it's not ready
for review.

```yaml
pull_request_rules:
  - name: convert to draft
    conditions:
      - "#check-failure > 0"
    actions:
      edit:
        draft: true
```