---
title: "Replace Inputs"
method: PUT
path: "/v1/matters/{matter_id}/inputs"
tags: ["matter-inputs"]
---

# Replace Inputs

`PUT /v1/matters/{matter_id}/inputs`

## 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}/inputs`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Request body

- ReplaceMatterInputs
  - `version` integer, required
  - `inputs` MatterInputsDocumentInput, required: The shared facts supplied for a matter, not a feature-specific workspace.
    - `schema_version` 'matter-inputs.v2'
    - `parties` MatterPartyInputInput[]
      - `id` string, uuid
      - `kind` 'person' | 'organisation' | 'trust' | 'government' | 'other', required
      - `name` string, required
      - `aliases` string[]
      - `acn` string, nullable
      - `abn` string, nullable
    - `relationships` union[]
      - union
        - DirectorRelationshipInputInput
          - `id` string, uuid
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable
          - `kind` 'director'
          - `role` 'director' | 'shadow_director' | 'former_director'
          - `from_date` string, date, nullable
          - `to_date` string, date, nullable
        - AssociateRelationshipInputInput
          - `id` string, uuid
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable
          - `kind` 'associate'
          - `relationship` 'spouse' | 'de_facto' | 'child' | 'parent' | 'sibling' | 'other'
        - RelatedEntityRelationshipInputInput
          - `id` string, uuid
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable
          - `kind` 'related_entity'
          - `nature` 'subsidiary' | 'parent' | 'commonly_controlled' | 'director_owned' | 'trust' | 'other'
        - CreditorRelationshipInputInput
          - `id` string, uuid
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable
          - `kind` 'creditor'
          - `debt_aud` string, decimal, nullable
          - `has_issued_demand` boolean
          - `demand_date` string, date, nullable
        - TradeSupplierRelationshipInputInput
          - `id` string, uuid
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable
          - `kind` 'trade_supplier'
          - `nature` 'supply' | 'rent' | 'utilities' | 'professional_services' | 'other'
    - `practitioner_notes` PractitionerNoteInputInput[]
      - `id` string, uuid
      - `scope` 'matter' | 'voidables' | 'sbr_eligibility' | 'sbr_scenario'
      - `title` string, nullable
      - `text` string, required

## Response `200`

Successful Response

- MatterInputsResponse
  - `matter_id` string, uuid, required
  - `version` integer, required
  - `inputs` MatterInputsDocumentOutput, required: The shared facts supplied for a matter, not a feature-specific workspace.
    - `schema_version` 'matter-inputs.v2', required
    - `parties` MatterPartyInputOutput[], required
      - `id` string, uuid, required
      - `kind` 'person' | 'organisation' | 'trust' | 'government' | 'other', required
      - `name` string, required
      - `aliases` string[], required
      - `acn` string, nullable, required
      - `abn` string, nullable, required
    - `relationships` union[], required
      - union
        - DirectorRelationshipInputOutput
          - `id` string, uuid, required
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable, required
          - `kind` 'director', required
          - `role` 'director' | 'shadow_director' | 'former_director', required
          - `from_date` string, date, nullable, required
          - `to_date` string, date, nullable, required
        - AssociateRelationshipInputOutput
          - `id` string, uuid, required
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable, required
          - `kind` 'associate', required
          - `relationship` 'spouse' | 'de_facto' | 'child' | 'parent' | 'sibling' | 'other', required
        - RelatedEntityRelationshipInputOutput
          - `id` string, uuid, required
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable, required
          - `kind` 'related_entity', required
          - `nature` 'subsidiary' | 'parent' | 'commonly_controlled' | 'director_owned' | 'trust' | 'other', required
        - CreditorRelationshipInputOutput
          - `id` string, uuid, required
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable, required
          - `kind` 'creditor', required
          - `debt_aud` string, decimal, nullable, required
          - `has_issued_demand` boolean, required
          - `demand_date` string, date, nullable, required
        - TradeSupplierRelationshipInputOutput
          - `id` string, uuid, required
          - `party_id` string, uuid, required
          - `related_party_id` string, uuid, nullable, required
          - `kind` 'trade_supplier', required
          - `nature` 'supply' | 'rent' | 'utilities' | 'professional_services' | 'other', required
    - `practitioner_notes` PractitionerNoteInputOutput[], required
      - `id` string, uuid, required
      - `scope` 'matter' | 'voidables' | 'sbr_eligibility' | 'sbr_scenario', required
      - `title` string, nullable, required
      - `text` string, required
  - `updated_at` string, date-time, nullable, required
  - `updated_by` string, uuid, nullable, 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/a5849ac366ca?raw)