Agent events

Why events matter

Your primary application (and agents) can record usage so you can answer questions like:

• Which datasets were used most?
• What did the agent search for?
• What datasets were opened/read during a workflow?

Endpoint

POST /api/events

Auth:

• Admin token, OR
• API key with scope events:write

Body:

{
  "datasetId": "<uuid>",
  "eventType": "dataset.read",
  "actor": "agent-name",
  "source": "mcp",
  "metadata": {"project": "customer-xyz"}
}

Event naming conventions

Recommended:

• dataset.read
• dataset.search
• dataset.used
• dataset.exported

You can store arbitrary metadata per event.