Update Foreign Property

PUT /tenants/{tenant}/clients/{client}/mtd/foreign-properties/property/{propertyId}/{taxYear}

Renames a registered foreign property, or records that it stopped producing income. Keyed by the property id alone — HMRC's own path shape. The country cannot be changed: a property registered against the wrong one is ended as added in error and registered again, because figures already filed name it by its identifier.

Parameters

Name	Type	Description
tenant*	path string	The Tenant.Code
The Tenant.Code
client*	path string
propertyId*	path string
taxYear*	path string

Request Body*

UpdateMtdForeignPropertyRequest

{
  "propertyName": "string",
  "endDate": "2024-01-01",
  "endReason": "Unknown"
}

Responses

200 OK

MtdSubmissionReceiptDto

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found