Webex Contact Center APIs are also protected with rate limiting. You are responsible for architecting and coding your application responsibly so as to not create too much traffic. The token generated by this Portal has special rate limit restrictions and is not suitable for production use. Follow the Authentication guide to experience realistic rate limit restrictions.

Note: The current default rate limit for a given client ID is 300 requests per minute.

anchorResponse Format

Every rate limited request will have a 429 response with a retry-after header included. This means your request has not been processed. Do not try again until after the retry-after duration (in seconds) has passed, else you will receive another 429 response. For example, a 4 second wait time will look like so:

Retry-After: 4

anchorBest Practices

Before contacting Cisco for any rate limit issues, make sure you are following API best practices:

Architectural

• If you are polling an API to find changes, consider subscribing to webhooks instead.
• If you are polling on a regular interval (hourly, every 15 minutes, etc.), consider scheduling different organizations or jobs at different times within the interval, perhaps using a hash.
• Consider implementing your own limits to prevent a single customer from causing your app to exceed rate limits.
• Consider aggregating requests and using batch or bulk APIs.
• For paginated APIs, avoid requesting unnecessary pages.

Coding

• User requests: Provide immediate feedback to users, suggesting a retry and displaying the retry-after value.
• Background tasks: Respect the retry-after header by waiting the specified duration before retrying.
• Prevent infinite retries: Implement a maximum retry count.

Increasing Rate Limits

Webex Contact Center prioritizes the security of our systems and customer data by continuously monitoring network traffic. To help developers get started and support organizations with up to 250 users, we offer default rate limits. If your organization has more than 250 users and requires higher rate limits, please contact Developer Support to discuss your specific needs.

Rate Limit Tiers