---
title: "Update Settings"
method: PUT
path: "/v1/matters/{matter_id}/cash-book/bas/settings"
tags: ["cash-book"]
---

# Update Settings

`PUT /v1/matters/{matter_id}/cash-book/bas/settings`

## 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}/cash-book/bas/settings`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- BasSettings
  - `version` integer
  - `gst_registered` boolean, nullable
  - `registration_start` string, date, nullable
  - `representative_commencement` string, date, nullable
  - `accounting_basis` 'cash' | 'non_cash', nullable
  - `reporting_method` 'simpler' | 'full', nullable
  - `gst_group_member` boolean, nullable
  - `payg_withholding` boolean, nullable
  - `obligations` string[]
  - `representative_ceased` string, date, nullable
  - `ato_cessation_notified` string, date, nullable
  - `pre_appointment_bas` PreAppointmentBasInput[]
    - `period_start` string, date, required
    - `period_end` string, date, required
    - `status` 'outstanding' | 'lodged' | 'not_required', required
    - `ato_direction_received` boolean

## Response `200`

Successful Response

- BasSettingsView
  - `version` integer, required
  - `gst_registered` boolean, nullable, required
  - `registration_start` string, date, nullable, required
  - `representative_commencement` string, date, nullable, required
  - `accounting_basis` 'cash' | 'non_cash', nullable, required
  - `reporting_method` 'simpler' | 'full', nullable, required
  - `gst_group_member` boolean, nullable, required
  - `payg_withholding` boolean, nullable, required
  - `obligations` string[], required
  - `representative_ceased` string, date, nullable, required
  - `ato_cessation_notified` string, date, nullable, required
  - `pre_appointment_bas` PreAppointmentBasOutput[], required
    - `period_start` string, date, required
    - `period_end` string, date, required
    - `status` 'outstanding' | 'lodged' | 'not_required', required
    - `ato_direction_received` boolean, required
  - `frequency` string, nullable, required
  - `appointment_date` string, date, nullable, required
  - `can_prepare` boolean, required
  - `can_manage` 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)