---
title: Record cache usage events
description: Records cache usage analytics events. The body of this request is an array of cache usage events.

This endpoint is optional but enables cache hit/miss analytics. Implementers can use this data to track cache effectiveness and optimize storage.

Event types:
- `HIT`: A cached artifact was found and used
- `MISS`: No cached artifact was found for the given hash

Source types:
- `LOCAL`: The cache event was on the user's local filesystem cache
- `REMOTE`: The cache event is for the remote cache
---

# Record cache usage events



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document={"remote-cache"} operations={[{"path":"/artifacts/events","method":"post"}]} />


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)