---
title: "Open Rule Book Draft"
method: POST
path: "/v1/rule-books/{rule_book_id}/draft"
tags: ["Rule Books"]
---

# Open Rule Book Draft

`POST /v1/rule-books/{rule_book_id}/draft`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/rule-books/{rule_book_id}/draft`
- Auth: none declared

Open a draft from the version in use. Refused while a draft is open. The first edit also opens one.

## Path parameters

- `rule_book_id` string, required: The rule book id (`rbk_…`).

## Response `200`

OK

- DraftOpenResult
  - `draft` DraftSummary, required
    - `id` string, required
    - `number` integer, required
    - `etag` string, required
    - `opened` ActorAt, required
      - `actor` Actor, required: Who did something. Built by the API layer from the request's credentials, never sent by a client.
        - `type` 'person' | 'agent' | 'integration', required
        - `id` string, required
        - `display` string, required
      - `at` string, date-time, required
    - `parent_version_number` integer, nullable, required

## Other responses

- `422`: Unprocessable Content

---

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