API v1
v1
View as Markdown

Delete a stay

DELETE /api/v1/vaults/{vault}/possessions/{possession}/location-stays/{stay}

Delete one stay of a possession.

The deletion is final. The other stays are not moved, so its period shows as unrecorded. Deleting the open stay leaves the possession with no current location until it is moved. The location itself stays. 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.

stay uuid Required

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

Returns

Nothing. A stay 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/schrute-farms/possessions/5e1b7c93-4a28-4d6f-9b02-7c3e8a1f4d60/location-stays/3b9e4f27-8d61-4c0a-a5f3-1e7c2d9b6a48 \
-X DELETE \
-H "Authorization: Bearer $MONICA_TOKEN"
const response = await fetch('https://my.monicahq.com/api/v1/vaults/schrute-farms/possessions/5e1b7c93-4a28-4d6f-9b02-7c3e8a1f4d60/location-stays/3b9e4f27-8d61-4c0a-a5f3-1e7c2d9b6a48', {
method: 'DELETE',
headers: { Authorization: `Bearer ${token}` },
})
$response = Http::withToken($token)->delete('https://my.monicahq.com/api/v1/vaults/schrute-farms/possessions/5e1b7c93-4a28-4d6f-9b02-7c3e8a1f4d60/location-stays/3b9e4f27-8d61-4c0a-a5f3-1e7c2d9b6a48');
Response 204
[]

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