Quick question about Analytics API 429 on interaction summary

General Discussion
1

Quick question about the POST /api/v2/analytics/summaries/aggregates/query endpoint returning 429 errors. The ServiceNow scheduled job hits this every hour for the last 30 days.

The rate limit header shows X-RateLimit-Reset in 60 seconds, but the job retries immediately after the first failure. This causes a cascade of blocks for the entire import set.

Is there a documented backoff strategy for bulk analytics pulls, or should I move this to an async Data Action instead?

2

Implement an exponential backoff strategy in the ServiceNow scheduled job. Parse the X-RateLimit-Reset header from the 429 response.

var resetTime = parseInt(response.getHeader('X-RateLimit-Reset'));
sleep((resetTime + 1) * 1000); // Wait slightly longer than reset

This prevents cascading blocks. The analytics API enforces strict limits on bulk summary pulls.

1 Like