MagicDoorAPI
SupportOpen MagicDoor
Owner transfers

Replace the attachments on an owner contribution

Sets the whole attachment list on an owner contribution 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/contributions/{ownerContributionId}/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

ownerContributionIdstringrequired

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

example: 1842110447398404096

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 contribution. A Snowflake id sent as a decimal string.

ownerIdstring

The owner who put the money in.

contributionDatestring · date

The day the money was contributed.

totalAmountnumber

How much the owner contributed, in dollars and cents. Always positive — money coming into the property from the owner.

allocatedAmountnumber

How much of it has been matched to an accounting transaction.

dueAmountnumber

What has not yet been matched: totalAmount less allocatedAmount.

memostring

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

referencestring

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

lineItemsobject[]

The contribution broken down by property, in display order.

filesobject[]

Files attached to the record.

metadataobject

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

createdstring · date-time

When the contribution 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 contribution with that id exists for the caller's company.