API v1
v1
View as Markdown

Remove a document from a valuation

DELETE /api/v1/vaults/{vault}/possessions/{possession}/valuations/{valuation}/documents/{file}

Remove a document from a valuation. The change is written to the account log.

The file is let go rather than deleted outright. It stays wherever else it is used, and is swept up after a grace period once nothing uses it.

Path parameters

Sent as JSON. Anything not listed here is ignored.

vault string Required

The vault the possession is kept in, named either by the readable name it reports as slug or by its id. A vault of another account answers 404.

possession uuid Required

The id of the possession. A possession of another vault or of another account answers 404.

valuation uuid Required

The id of the valuation. A valuation of another possession answers 404.

file uuid Required

The id of the document, as the documents of the valuation give it. A document of another valuation answers 404.

Returns

Nothing. A valuation of another possession, a document of another valuation or of another account answers 404.

Rate limit

Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.

DELETE
curl https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/valuations/3d7b1e94-8a2c-4f60-b5d3-6e19c0a7f248/documents/6f2a9d48-1c7e-4b35-a8f0-2e5d9b4c7a16 \
-X DELETE \
-H "Authorization: Bearer $MONICA_TOKEN"
const response = await fetch('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/valuations/3d7b1e94-8a2c-4f60-b5d3-6e19c0a7f248/documents/6f2a9d48-1c7e-4b35-a8f0-2e5d9b4c7a16', {
method: 'DELETE',
headers: { Authorization: `Bearer ${token}` },
})
$response = Http::withToken($token)->delete('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/valuations/3d7b1e94-8a2c-4f60-b5d3-6e19c0a7f248/documents/6f2a9d48-1c7e-4b35-a8f0-2e5d9b4c7a16');
Response 204
[]

Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.