---
title: "Create Doi Run"
method: POST
path: "/v1/matters/{matter_id}/doi/assessment/{assessment_id}/runs"
tags: ["date-of-insolvency"]
---

# Create Doi Run

`POST /v1/matters/{matter_id}/doi/assessment/{assessment_id}/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}/doi/assessment/{assessment_id}/runs`
- Auth: HTTP bearer

## Path parameters

- `assessment_id` string, uuid, required
- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateDoiRun
  - `category_sources` CategorySourceInput[]
    - `category` 'financial' | 'ato' | 'finance' | 'claims' | 'indicators' | 'ppsr', required
    - `source` 'matter_memory' | 'selected_documents' | 'xero' | 'ppsr', required
    - `document_ids` string[]
  - `refresh_category` 'financial' | 'ato' | 'finance' | 'claims' | 'indicators' | 'ppsr'
  - `expected_active_run_id` string, uuid, nullable
  - `financial_source` 'matter_memory' | 'xero', required
  - `include_matter_memory` boolean, required
  - `document_ids` string[]
  - `reopen_finalised_decision` boolean
  - `expected_decision_revision` integer, nullable

## Response `202`

Successful Response

- RunAccepted
  - `run_id` string, uuid, required
  - `job_id` string, uuid, required
  - `ordinal` integer, required
  - `status` 'accepted' | 'pending_delivery' | 'running' | 'waiting' | 'succeeded' | 'failed_retryable' | 'failed_terminal' | 'cancelled', required
  - `replayed` 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)