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

# Publish Rule Book Draft

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

## Request

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

The draft becomes the version in use. Needs the draft's etag in `If-Match`. Refused with its blockers when the draft changes nothing or a rule needs fixing.

## Path parameters

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

## Request body

- DraftPublish
  - `summary` string, nullable

## Response `200`

OK

- PublishResult
  - `version` VersionSummary, required
    - `id` string, required
    - `number` integer, required
    - `state` 'draft' | 'published' | 'superseded' | 'discarded', required
    - `summary` string, nullable, required
    - `published` 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
  - `superseded` VersionRef, required
    - `id` string, required
    - `number` integer, required
    - `state` 'draft' | 'published' | 'superseded' | 'discarded', required
  - `strategies` integer, 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)