Owner transfers

Replace the attachments on an owner transfer

Sets the whole attachment list on an owner transfer to what you send, so files left out are detached. Use it to reorder attachments or change their descriptions.

PATCH
https://api.portal.magicdoor.com/company-app/owners/transfers/{ownerTransferId}/files

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

ownerTransferIdstringrequired

The owner transfer. A Snowflake id sent as a decimal string.

example: 1840110447398404096

Body

application/json

filesobject[]required

The attachments after the change. This replaces the existing list. At least one entry.

Response

200 · The record with its attachments after the change.

idstring

The owner transfer. A Snowflake id sent as a decimal string.

ownerIdstring

The owner whose money is being moved. Both properties must be theirs.

transferDatestring · date

The day the money moved.

amountnumber

How much moved, in dollars and cents. Always positive: it leaves the source property and arrives at the destination property.

sourceobject

The source side of the transfer — where the money leaves.

destinationobject

The destination side of the transfer — where the money arrives.

memostring

A note on the transfer. Absent when none was set.

referencestring

A reference on the transfer. Absent when none was set.

filesobject[]

Files attached to the record.

metadataobject

Free-form key-value pairs kept on the transfer.

createdstring · date-time

When the transfer was created, in the company's timezone.

updatedstring · date-time

When it last changed, in the company's timezone.

creatorobject

Who created the record.

ownerobject

The owner named by ownerId, as the full owner record.

portfoliosobject[]

The portfolios the lines belong to, resolved.

propertiesobject[]

The properties the lines apply to, resolved.

transactionsobject[]

The accounting transactions behind the allocations, resolved.

bankAccountsobject[]

The bank accounts those transactions moved money through, resolved. Account and routing numbers are masked to their last four digits.

chartOfAccountsobject[]

The chart of accounts the lines book to, resolved.

hydratedFilesobject[]

The attachments in files, resolved to full file records with signed download URLs.

creatorInfoobject

The person behind creator, resolved. Exactly one of propertyManager, vendor, tenant and owner is present, matching creator.type.

400 · `files` is empty or an entry is missing `fileId`.

401 · The access token is missing, expired, or does not belong to a property manager.

404 · No owner transfer with that id exists for the caller's company.