API v1
v1
View as Markdown

Delete a valuation

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

Delete a valuation of a possession.

The deletion is final. When the valuation gave the current value, the latest one left gives it instead. Its documents are let go and swept up after a grace period once nothing uses them. The account log keeps the name of the possession.

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.

Returns

Nothing. A valuation of another possession 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/b81f5c3a-2d49-4e7b-9a06-f4c8e2d17b53 \
-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/b81f5c3a-2d49-4e7b-9a06-f4c8e2d17b53', {
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/b81f5c3a-2d49-4e7b-9a06-f4c8e2d17b53');
Response 204
[]

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