---
title: "Prepare Change"
method: POST
path: "/v1/matters/{matter_id}/remuneration/approvals/{approval_id}/changes"
tags: ["remuneration"]
---

# Prepare Change

`POST /v1/matters/{matter_id}/remuneration/approvals/{approval_id}/changes`

## 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}/remuneration/approvals/{approval_id}/changes`
- Auth: HTTP bearer

## Path parameters

- `approval_id` string, uuid, required
- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- PrepareApprovalChange
  - `expected_version` integer, required
  - `terms` ApprovalTerms, required
    - `approval_basis` 'time_costs_capped' | 'fixed_fee' | 'percentage', required
    - `work_scope` 'retrospective' | 'prospective' | 'mixed'
    - `period_start` string, date, nullable
    - `period_end` string, date, nullable
    - `approved_amount` string, decimal, nullable
    - `approved_percentage` string, decimal, nullable
    - `percentage_base` string, nullable
    - `description` string, nullable
    - `rate_schedule_sha256` string, nullable
    - `requested_amount` string, decimal, nullable
    - `authority_type` 'creditor_resolution' | 'committee_of_inspection' | 'members_resolution' | 'court_order' | 'fixed_at_appointment' | 'afsa_determination' | 'board_resolution' | 'accepted_terms' | 'default_cap', required
    - `approval_date` string, date, required
    - `work_scope_derived` boolean
    - `authority_reference` string, nullable
    - `authority_wording` string, nullable
    - `authority_event` 'meeting' | 'proposal_without_meeting' | 'court_order' | 'appointment_document' | 'afsa_determination' | 'board_resolution' | 'creditor_acceptance': The event that made the determination, not merely a linked meeting.
    - `percentage_base_amount` string, decimal, nullable
    - `authority_document_id` string, uuid, nullable
    - `approval_report` ApprovalReportLink: The memory document sent to the determining body, and when.
      - `document_id` string, uuid, required
      - `sent_at` string, date-time, required
    - `work_categories` WorkCategory[], nullable
  - `subsequent_determination` boolean
  - `change_reason` string, required

## Response `201`

Successful Response

- ApprovalChangeResult
  - `change_id` string, uuid, 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)