Skip to main content
POST
/
api
/
public
/
record-usage
curl -X POST "https://api.crovver.com/api/public/record-usage" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "requestingEntityId": "workspace_123",
    "metric": "api_calls",
    "value": 1,
    "metadata": { "endpoint": "/api/export", "userId": "user_456" }
  }'

{
  "success": true,
  "data": {
    "message": "Usage recorded",
    "metric": "api_calls",
    "recordedValue": 1
  }
}
This endpoint is deprecated. Use POST /api/credits/consume instead — it deducts directly from the credit ledger, is idempotent via idempotencyKey, and returns the remaining balance in a single call.
Records a usage event for a tenant. Crovver accumulates these events and checks them against the plan’s limits when check-usage-limit is called.

​
Request Body

​
requestingEntityId
string
required
The external tenant ID
​
metric
string
required
The metric to record (must match a key in plan.limits)
​
value
number
Amount to add. Defaults to 1.
​
metadata
object
Optional context (e.g., which user triggered the event)

​
Authentication

Requires a secret key (Authorization: Bearer sk_live_...). 
curl -X POST "https://api.crovver.com/api/public/record-usage" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "requestingEntityId": "workspace_123",
    "metric": "api_calls",
    "value": 1,
    "metadata": { "endpoint": "/api/export", "userId": "user_456" }
  }'

{
  "success": true,
  "data": {
    "message": "Usage recorded",
    "metric": "api_calls",
    "recordedValue": 1
  }
}