---
title: "Prepare a finalized draft for signature"
method: POST
path: "/drafts/{draft_id}/envelope"
tags: ["draft"]
---

# Prepare a finalized draft for signature

`POST /drafts/{draft_id}/envelope`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/drafts/{draft_id}/envelope`
- Auth: HTTP bearer

Makes an envelope draft of the finalized document with its signers from the template: for a board consent, every director on record and no one else, each with a signature and date field at their own signature block. Sending the envelope is envelope.send, which follows the approval rules: an agent's or API key's send waits for a person.

## Path parameters

- `draft_id` string, required

## Request body

- object

## 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)