SaaSFlow
DevelopersAPIReferencefiles

Delete file

Delete a file and its stored document. The transactions it was attached to are untouched, but they lose their supporting receipt, which matters if the books are audited. To detach without destroying the document, clear `transactionIds` with `PUT` instead.

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.
DELETE
/companies/{companyId}/files/{fileId}

Authorization

Authorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

In: header

Path Parameters

companyId*string
Length1 <= length
fileId*string
Length1 <= length

Response Body

application/json

curl -X DELETE "https://example.com/companies/string/files/string"
{  "success": true}

Retrieve file

Retrieve one file's metadata: filename, size, what it is attached to, and the parsed amount and date. This returns the record, not the document. Use the `/download` sub-resource for the bytes. Returns 404 if the file does not exist or belongs to another company.

Update file

Update a file record: rename it, correct the parsed amount, date, or document type, or change which transactions it is attached to. `transactionIds` replaces the attachment list rather than adding to it, so include the ids you want to keep. This is how a receipt gets matched to the payment it belongs to.