---
title: "Choose one creative alternative and create a draft"
method: POST
path: "/publication-builds/{id}/options/{option_id}/commit"
tags: ["Publication Builds"]
---

# Choose one creative alternative and create a draft

`POST /publication-builds/{id}/options/{option_id}/commit`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/publication-builds/{id}/options/{option_id}/commit`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Path parameters

- `id` string, required
- `option_id` string, required

## Request body

- CommitPublicationOptionInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `edits` OptionEdit[], nullable: Author-edited text and visual recipes for the chosen alternative
    - `account_id` string, required
    - `document` ScreenshotTemplateDocument
      - `appearance` 'light' | 'dark', required
      - `conversation` ScreenshotTemplateConversation
        - `messages` ScreenshotTemplateMessage[], required
          - `id` string, required
          - `image_media_id` string
          - `sender_id` string, required
          - `text` string, required
        - `name` string, required
        - `people` ScreenshotTemplatePerson[], required
          - `avatar_media_id` string
          - `id` string, required
          - `name` string, required
        - `read_receipt` string, required
        - `self_id` string, required
        - `show_header` boolean, required
        - `timestamp` string, required
      - `frame` 'natural' | 'square' | 'portrait', required
      - `meme` ScreenshotTemplateMeme
        - `alt_text` string
        - `captions` string[], required
        - `format` 'png' | 'webp' | 'gif', required
        - `name` string, required
        - `overlay_media_ids` string[], required
        - `overlay_slots` integer, required
        - `parent_media_id` string
        - `template_id` string, required
      - `receipt` ScreenshotTemplateReceipt
        - `address` string, required
        - `business` string, required
        - `currency` 'USD' | 'EUR' | 'GBP' | 'BRL' | 'JPY', required
        - `custom_total` string, required
        - `footer` string, required
        - `items` ScreenshotTemplateReceiptItem[], required
          - `amount_cents` integer, required
          - `id` string, required
          - `name` string, required
          - `quantity` integer, required
        - `order` string, required
        - `tax_percent` number, double, required
        - `timestamp` string, required
      - `schema_version` 1, required
      - `status_page` ScreenshotTemplateStatus
        - `headline` string, required
        - `name` string, required
        - `severity` 'operational' | 'degraded' | 'outage', required
        - `updates` ScreenshotTemplateStatusUpdate[], required
          - `id` string, required
          - `stage` string, required
          - `text` string, required
          - `timestamp` string, required
      - `template_id` 'messages' | 'group-chat' | 'receipt' | 'status-page' | 'meme', required
      - `text_size` 'small' | 'normal' | 'large', required
      - `title` string, required
    - `segments` SegmentPlan[], nullable, required
      - `body` string, required
      - `description` string
      - `title` string
  - `expected_revision` integer, required: Revision read with the selected option snapshot
  - `media` OptionMedia[], nullable: Rendered Workspace image IDs for the selected alternative
    - `account_id` string, required
    - `media_id` string, required

## Response `200`

OK

- CommitPublicationBuildOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `href` string, required: Composer path for review and editing
  - `publication_id` string, required: Draft Publication created from the approved build

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)