Record Usage (Deprecated)

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

string

required

The external tenant ID

string

required

The metric to record (must match a key in plan.limits)

number

Amount to add. Defaults to 1.

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
  }
}

Check Usage Limit (Deprecated)Deprecated. Use credits/balance + credits/consume instead.

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
  }
}

Overview

Subscriptions

Checkout

Credits

Add-ons

Capacity (Seats)

Features & Usage

Plans

Tenants

Deprecated

Record Usage (Deprecated)

Request Body

Authentication

​Request Body

​Authentication

Request Body

Authentication