---
title: "Updates a tenancy using JSON Patch"
method: PATCH
path: "/tenancies/{tenancyId}"
tags: ["Tenancies"]
---

# Updates a tenancy using JSON Patch

`PATCH /tenancies/{tenancyId}`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/tenancies/{tenancyId}`
- Auth: `appAuth` (a scheme the document does not define)

## Path parameters

- `tenancyId` integer, required

## Headers

- `AgencyRef` string, required

## Request body

- SystemTextJsonPatchOperationsOperation1AltoPropertyManagementApiModelsTenancyPatch[]: Array of operations to perform
  - union
    - object: The rent amount of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` number
      - `path` string
    - object: The rent frequency of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` string
      - `path` string
    - object: The requested deposit of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` number
      - `path` string
    - object: The start date of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` string
      - `path` string
    - object: The term years of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` integer
      - `path` string
    - object: The term months of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` integer
      - `path` string
    - object: The target vacate date of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` string
      - `path` string
    - object: The first full rent date of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` string
      - `path` string
    - object: The notice to quit date of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` string
      - `path` string
    - object: The end date of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` string
      - `path` string
    - object: The renewal date of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` string
      - `path` string
    - object: The tenants Ids of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` integer
      - `path` string
    - object: Current DepositSchemeType of the Tenancy
      - `op` 'replace'
      - `value` string
      - `path` string
    - object: The occupants count of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` integer
      - `path` string
    - object: The occupant names of the tenancy
      - `op` 'add' | 'replace' | 'remove' | 'test'
      - `value` string
      - `path` string
    - object: The Registration Number of the tenancy deposit
      - `op` 'replace'
      - `value` string
      - `path` string

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)