v1

latestOpenAPI 3.0.02026-07-1715378310.4 KB
analytics

put/api/v1/analytics/settings

Request body

analyticsRetentionDaysnumber

Data retention period in days (must be within tier limits)

subscriptionTier'free' | 'pro' | 'enterprise'

Subscription tier (optional - usually set by billing system)

Example request

{
  "analyticsRetentionDays": 30
}

Response

Update analytics settings for the authenticated organization

organizationIdstring required

Organization ID

subscriptionTier'free' | 'pro' | 'enterprise' required

Subscription tier

analyticsRetentionDaysnumber required

Data retention period in days

maxRetentionDaysnumber required

Maximum retention days allowed for this tier

createdAtstring date-time required

Timestamp when settings were created

updatedAtstring date-time required

Timestamp when settings were last updated

Example response

{
  "organizationId": "org_abc123",
  "subscriptionTier": "free",
  "analyticsRetentionDays": 30,
  "maxRetentionDays": 30,
  "createdAt": "2026-01-20T00:00:00.000Z",
  "updatedAt": "2026-01-20T00:00:00.000Z"
}