MagicDoorAPI
SupportOpen MagicDoor
Vendor bills

Remove files from a vendor bill

Detaches files from the bill and deletes them from storage. Requires the vendor_bills:write permission, plus vendor_bills:read, because the endpoint reads the bill back to return it.

DELETE
https://services.magicdoor.com/accounting/company-portal/vendor-bills/{vendorBillId}/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

vendorBillIdstringrequired

Snowflake id of the vendor bill.

example: 1830472847398404200

Body

application/json

Every id must currently be attached to this bill. If any one is not, nothing is removed.

fileIdsstring[]required

Snowflake ids of attachments on this bill, at least one.

example: ["1830472847398404600"]

Response

200 · The vendor bill without those files, read back in full.

idstring

Snowflake id of the vendor bill.

createdstring · date-time

When the bill was recorded, in the company's timezone.

updatedstring · date-time

When the bill was last changed, in the company's timezone.

companyBillboolean

true when the management company owes this bill itself; false when a property owner does, in which case every line carries a property context.

billDatestring · date

The date the vendor issued the bill.

dueDatestring · date

The date the vendor expects payment.

memostring

Free-text note on the bill. Absent when none was set.

referencestring

The vendor's own invoice number or reference. Absent when none was set.

sourceTypeenum<string>

What the bill was raised from. Absent when it is not linked to anything.

workOrder
sourceIdstring

Id of the record named by sourceType. Absent when sourceType is.

vendorIdstring

The vendor who issued the bill.

statusenum<string>

Where the bill sits in the approval flow. Bills created through this API start as draft; none of these endpoints move it on.

draftpendingapprovedrejectedwithdrawn
assignedToIdstring

The property manager the bill is waiting on. Absent while nobody is assigned.

assignedByIdstring

The property manager who assigned it. Absent while nobody is assigned.

assignedAtstring · date-time

When it was assigned, in the company's timezone. Absent while nobody is assigned.

totalAmountnumber

Sum of every line item's amount, as a decimal.

allocatedAmountnumber

Sum of every line item's allocatedAmount — how much of the bill has been paid.

dueAmountnumber

totalAmount minus allocatedAmount — what is still outstanding on the bill.

lineItemsLineItem[]

The bill's lines, in order. There is always at least one.

filesFile[]

Scanned invoices and other attachments.

creatorobject

Who recorded the bill. Deprecated mirrors of id — propertyManagerId, tenantId, vendorId, ownerId — are also present, whichever matches type.

401 · The access token is missing, expired, or not for this company.

403 · The caller does not hold both the `vendor_bills:write` and `vendor_bills:read` permissions. A caller holding only `vendor_bills:write` gets a 403 **after the change has been applied**, because the response is read back through the read-gated path.

404 · The bill is not in this company, or one of the `fileIds` is not attached to it.

The file itself is deleted

This does more than unlink: after the bill is updated, the stored file is deleted too. There is no endpoint that brings it back.