Legacy Dev Forum Posts

 View Only

Sign Up

  • 1.  Bulk User Deletion

    Posted 06-05-2025 18:04

    WetkarS | 2023-10-18 11:42:20 UTC | #1

    Hello team,

    I am working on developing some applications using Genesys Public APIs. One of them is bulk deletion of users. I will be using

    DELETE: /api/v2/users/{userId}.

    I will be recursively calling this API to delete the user IDs in bulk. What i need to know is the rate limiting on this API ( or Users API ) ? How many of such API Callouts can be done in a day/hour/minute or seconds ?

    I was going through this URL in dev center: https://developer.genesys.cloud/organization/organization/limits

    But did not find any mention of limits on /api/v2/users/*

    let me know if i am missing anything.

    Br, Sannket


    Jerome.Saint-Marc | 2023-10-18 11:50:27 UTC | #2

    Hello,

    180 per minute (per token/clientId) in this case.

    You can find info on limits for a specific endpoint (apart from the org limit you referenced in your post) in the API Explorer. DELETE /api/v2/users/{userId} - Expand "Operation Information" section -> "Resources Limits"

    Regards,


    WetkarS | 2023-10-18 12:16:10 UTC | #3

    Thank You Jerome !!! That helped, really....

    client.credentials.token.rate.per.minute

    The maximum number of requests per client credentials grant token per minute

    300

    api/v2/*

    yes

    org.app.user.rate.per.minute

    The maximum number of requests per organization per OAuth client per user per minute

    3000

    api/v2/*

    yes

    Can you please explain me, what these limits mean ? & when will these come into picture ?

    Thanks, Sannket Wetkar +91 9833343349


    Jerome.Saint-Marc | 2023-10-18 12:23:09 UTC | #4

    These are different limits which apply. They are not specific to DELETE endpoint. Ex: The maximum number of requests per client credentials grant token per minute - 300 per minute. It applies to all API requests starting with api/v2/* This one is not specific to the DELETE user endpoint. It is just a max number of API requests per token per minute (regardless of the endpoint you call). If the application has already made 220 API requests in the minute (not the DELETE endpoint), even if the limit for the users API is 180 and you have not consumed any, you can just have 80 API requests in the remaining of the current minute.

    That first one relates to an OAuth Client Credentials Grant based token (not related to a user). The second is a limit per OAuth Client (Implicit Grant, Authorization Code Grant) leveraged by a specific user.

    Regards,


    WetkarS | 2023-10-18 13:34:03 UTC | #5

    Perfect !!! One last question, will the API endpoint respond with 429 once additional call outs are made ?

    So that i can perform async operation to deal with 429 and retry after.

    Br, Sannket


    Jerome.Saint-Marc | 2023-10-18 13:47:36 UTC | #6

    Yes - it does respond with 429 when you reach any api limit. And you are correct - you can base your logic on 429 for retry. The 429 will specify how much time (seconds) you can have to wait. See this page on devcenter

    Regards,


    WetkarS | 2023-10-23 09:33:26 UTC | #7

    Hello Jerome/Genesys team,

    Thank You for help, so far !! If i refresh the token in 150 ( out of total 180) callouts { within 1 minutes, lets say 30 seconds }, will i be eligible to use next 180 API callout in next 30 seconds ?

    Br, Sannket


    system | 2023-11-23 09:34:13 UTC | #8

    This topic was automatically closed 31 days after the last reply. New replies are no longer allowed.


    This post was migrated from the old Developer Forum.

    ref: 22609