---
title: "PUT /api/v1/analytics/settings"
method: PUT
path: "/api/v1/analytics/settings"
tags: ["analytics"]
---

# PUT /api/v1/analytics/settings

`PUT /api/v1/analytics/settings`

## Request body

- UpdateAnalyticsSettingsDto
  - `analyticsRetentionDays` number — Data retention period in days (must be within tier limits)
  - `subscriptionTier` 'free' | 'pro' | 'enterprise' — Subscription tier (optional - usually set by billing system)

## Response `200`

Update analytics settings for the authenticated organization

- AnalyticsSettingsResponseDto
  - `organizationId` string, required — Organization ID
  - `subscriptionTier` 'free' | 'pro' | 'enterprise', required — Subscription tier
  - `analyticsRetentionDays` number, required — Data retention period in days
  - `maxRetentionDays` number, required — Maximum retention days allowed for this tier
  - `createdAt` string, date-time, required — Timestamp when settings were created
  - `updatedAt` string, date-time, required — Timestamp when settings were last updated

---

[API](https://skmtc.net/shipsecai/apis/shipsec-studio-api.md) · [All operations](https://skmtc.net/shipsecai/apis/shipsec-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipsecai/shipsec-studio-api/revisions/cc60562ad9f3/schema)