Secure, scalable cloud storage with enterprise-grade features and global availability
Standard retention for all video data
"default_days": number_of_daysLonger retention for detected anomalies
"anomaly_retention": number_of_daysCamera connection logs and status data
"stream_metadata": number_of_daysAggregated statistics and reports
"analytics_data": number_of_daysRetrieve your current data retention configuration
curl -X GET "https://api.perimi.ai/v1/storage/retention" \
-H "Authorization: Bearer YOUR_API_KEY"
# Response
{
"retention_policy": {
"default_days": 90,
"anomaly_retention": 365,
"stream_metadata": 30,
"analytics_data": 180
},
"storage_tiers": {
"active": 30,
"infrequent": 90,
"cold": 365
}
}Configure data retention periods via API
curl -X PUT "https://api.perimi.ai/v1/storage/retention" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"retention_policy": {
"default_days": 120,
"anomaly_retention": 730,
"stream_metadata": 60,
"analytics_data": 365
},
"auto_deletion": true
}'
# Response
{
"status": "success",
"updated_at": "2024-09-14T15:30:00Z"
}Configure retention for individual streams
curl -X POST "https://api.perimi.ai/v1/streams/stream_123/retention" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"retention_days": 180,
"priority_level": "high",
"custom_rules": {
"anomaly_extended": 1095,
"normal_footage": 90
}
}'
# Response
{
"stream_id": "stream_123",
"retention_applied": true,
"effective_date": "2024-09-14T15:30:00Z"
}Get detailed storage consumption and costs
curl -X GET "https://api.perimi.ai/v1/storage/usage?period=30d" \
-H "Authorization: Bearer YOUR_API_KEY"
# Response
{
"usage_summary": {
"total_gb": 1248.5,
"active_tier_gb": 234.2,
"infrequent_tier_gb": 456.8,
"cold_tier_gb": 557.5
},
"cost_breakdown": {
"active": "$18.73",
"infrequent": "$9.14",
"cold": "$2.23",
"total_monthly": "$30.10"
}
}Enable Perimi Cloud storage for your deployment today