---
title: "Create Generation"
method: POST
path: "/v1/matters/{matter_id}/day-ones/generation-runs"
tags: ["day-ones"]
---

# Create Generation

`POST /v1/matters/{matter_id}/day-ones/generation-runs`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/day-ones/generation-runs`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateGenerationRun: Generate document types, or regenerate named current documents. An empty request generates every applicable template. ``document_ids`` regenerates exactly those documents and leaves the rest of their types unchanged. ``recipients`` generates the first document for recipients added after their type was generated, even when other documents of that type are signed or sent. Neither can be combined with ``document_types``.
  - `allow_incomplete_drafts` boolean
  - `expected_configuration_version` integer, required
  - `document_types` string[]
  - `document_ids` string[]
  - `recipients` GenerationRecipient[]
    - `document_type` string, required
    - `subject_key` string, required
  - `template_inputs` object

## Response `202`

Successful Response

- DayOnesOperation
  - `id` string, uuid, required
  - `matter_id` string, uuid, required
  - `kind` 'infotrack_search' | 'public_register_search' | 'generate_pack' | 'meeting_pack' | 'refresh_document' | 'sign_document' | 'convert_pdf' | 'generate_director_pack' | 'generate_outgoings', required
  - `target_key` string, required
  - `state` 'queued' | 'running' | 'waiting' | 'completed' | 'failed' | 'cancelled', required
  - `stage` string, nullable, required
  - `version` integer, required
  - `poll_url` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `started_at` string, date-time, nullable, required
  - `terminal_at` string, date-time, nullable, required
  - `safe_issue_code` string, nullable, required
  - `safe_issue_detail` string, nullable, required
  - `document_types` string[], required
  - `document_ids` string[], required
  - `allowed_actions` string[], required
  - `template_release_updated` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)