# Formify Drafts API

**Canonical:** https://apis.io/apis/formify-eu/formify-eu-drafts-api/  
**Provider:** Formify — https://apis.io/providers/formify-eu/  
**Base URL:** https://docs-api.formify.eu/v1  
**Documentation:** https://developers.formify.eu/

Formify Drafts API is one of 10 APIs that [Formify](https://apis.io/providers/formify-eu/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Drafts. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

Drafts allow you to save a document as a work-in-progress before sending it for signing. A draft stores all document settings (name, signees, signature placements, AI assistant, etc.) without actually sending invitations to signees. **Draft Lifecycle:** 1. **Create** a draft with `POST /docs/drafts` — saves the document configuration 2. **Update** the draft with `PUT /docs/drafts/{draftId}` — modify any settings before sending 3. Optionally **preview** the draft with `GET /docs/drafts/{draftId}/file` — returns a PDF showing signature field placements 4. **Send** the draft with `POST /docs/drafts/{draftId}/send` — converts the draft into a live document and sends invitations to signees 5. Optionally **list** drafts with `GET /docs/drafts` or **get details** with `GET /docs/drafts/{draftId}` 6. **Delete** a draft with `DELETE /docs/drafts/{draftId}` if it's no longer needed **Who sees what:** `GET /docs/drafts` lists your own drafts plus the ones colleagues set to `sharingSetting: "shared"` — the same rule as `GET /docs`, `GET /templates` and `GET /links`. A `private` draft is readable by its owner alone. Each entry carries `userId` and `sharingSetting`, so you can tell your own from a colleague's. **Key Differences from `POST /docs`:** - Drafts do **not** send invitations to signees upon creation — they are saved for later. - Signee details are optional when creating/updating a draft. You can add them later via `PUT /docs/drafts/{draftId}`. - Signees in a draft do not need a contact method (email/phone) until the draft is sent. - Signature placement coordinates can be omitted or incomplete during the draft phase. - When sent via `POST /docs/drafts/{draftId}/send`, all the same validations as `POST /docs` apply (contact methods, signature coordinates, etc.). - Drafts expire automatically after the same auto-deletion period as other documents. Expired drafts cannot be edited or sent. **Shared Properties with `POST /docs`:** The request body for creating and updating drafts shares many of the same properties as `POST /docs`, including: - `signeeDetails` (signature types, placements, signatureBox, idScanBox, signingOrder) - `enableSigningOrder` (requires `signingOrder` capability) - `aiAssistant` configuration - `language`, `sharingSetting`, `personalMessage` - Signature type permission requirements (`signatureBankId`, `signatureIdScan`, `signatureFaceLiveness` capabilities) Refer to the `POST /docs` documentation above for details on these shared properties.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/docs/drafts` | Create a draft |
| GET | `/docs/drafts` | List drafts |
| PUT | `/docs/drafts/{draftId}` | Update a draft |
| GET | `/docs/drafts/{draftId}` | Get draft details |
| DELETE | `/docs/drafts/{draftId}` | Delete a draft |
| GET | `/docs/drafts/{draftId}/file` | Get a preview PDF of the draft |
| GET | `/docs/drafts/{draftId}/file-url` | Get a one-time download URL for the draft PDF |
| GET | `/docs/drafts/{draftId}/file-download/{token}` | Download a draft PDF using a one-time token |
| POST | `/docs/drafts/{draftId}/send` | Send a draft |
| POST | `/docs/drafts/{draftId}/duplicate` | Duplicate a draft |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/formify-eu/openapi/formify-eu-drafts-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/formify-eu/json-schema/formify-eu-create-draft-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/formify-eu/json-schema/formify-eu-update-draft-request-schema.json

## Other Formify APIs (9)

- [Formify Account API](https://apis.io/apis/formify-eu/formify-eu-account-api/)
- [Formify Auth API](https://apis.io/apis/formify-eu/formify-eu-auth-api/)
- [Formify Docs API](https://apis.io/apis/formify-eu/formify-eu-docs-api/)
- [Formify Files API](https://apis.io/apis/formify-eu/formify-eu-files-api/)
- [Formify Links API](https://apis.io/apis/formify-eu/formify-eu-links-api/)
- [Formify OAuth API](https://apis.io/apis/formify-eu/formify-eu-oauth-api/)
- [Formify Templates API](https://apis.io/apis/formify-eu/formify-eu-templates-api/)
- [Formify User API](https://apis.io/apis/formify-eu/formify-eu-user-api/)
- [Formify Webhooks API](https://apis.io/apis/formify-eu/formify-eu-webhooks-api/)

## Tags

Drafts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/formify-eu/formify-eu-drafts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/formify-eu/.