---
title: "Start a draft from a template"
method: POST
path: "/drafts"
tags: ["draft"]
---

# Start a draft from a template

`POST /drafts`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/drafts`
- Auth: HTTP bearer

Starts a draft of a library template with every blank a record fills already filled, each labelled with its record: the company from workspace settings, the round's target and forms, the directors and officers on record. A board consent needs round_id; drafting one for the same round again returns the open draft. Refused while the template's source changed, it's withdrawn, or it needs an attorney's review it doesn't have.

## Request body

- object
  - `template_key` string, required
  - `version` string
  - `round_id` string

## Response `200`

The result.

- object
  - `id` string, required
  - `template_key` string, required
  - `template_version` string, required
  - `title` string, required
  - `round_id` string, nullable, required
  - `status` 'draft' | 'finalized', required
  - `fields` object[], required
    - `name` string, required
    - `label` string, required
    - `type` 'text' | 'email' | 'money' | 'date' | 'forms' | 'people' | 'choice', required
    - `required` boolean, required
    - `options` object[], required
      - `value` string, required
      - `label` string, required
    - `from_records_only` boolean, required
    - `text` string, nullable, required
    - `input` string, nullable, required
    - `provenance` string, nullable, required
    - `quote` string, nullable, required
    - `source_ref` string, nullable, required
  - `missing` string[], required
  - `blocked` string, nullable, required
  - `rule_changes` string[], required
  - `rule_acknowledgment` object, nullable, required
    - `text` string, required
    - `by` string, required
    - `at` string, date-time, required
  - `signers` object[], required
    - `name` string, required
    - `email` string, nullable, required
  - `preview` object[], required
    - `id` string, required
    - `level` integer, required
    - `text` string, required
  - `provenance` object, required
    - `template_key` string, required
    - `title` string, required
    - `publisher` string, required
    - `source_url` string, required
    - `license` string, required
    - `source_version` string, required
    - `packaging_revision` integer, required
    - `source_sha256` string, required
    - `modifications` string, required
  - `explainer` object, nullable, required
    - `title` string, required
    - `url` string, required
  - `document_id` string, nullable, required
  - `version_id` string, nullable, required
  - `envelope_id` string, nullable, required
  - `consent` object, nullable, required
    - `id` string, required
    - `effective_on` string, date, nullable, required
    - `status` string, required
  - `created_at` string, date-time, required
  - `finalized_at` string, date-time, nullable, required

## Other responses

- `default`: An RFC 9457 problem.

---

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