SAP Knowledge Base Article - Public

3648498 - 429 error encountered when calling API /learning/odatav4/public/admin/user-service/v2/AI_mergeUser

Symptom

Persistent 429 error occurs when calling the API endpoint /learning/odatav4/public/admin/user-service/v2/AI_mergeUser

  • Error message received: "API calling limit exceeded, Try later"
  • Response code: 429 TOO_MANY_REQUESTS

Environment

SAP SuccessFactors Learning

Reproducing the Issue

  1. Implement a conservative rate-limiting strategy >
  2. Execute multiple merge operations using the API endpoint /learning/odatav4/public/admin/user-service/v2/AI_mergeUser >
  3. Observe that rate limits are hit after only 2–3 merge operations, resulting in 429 error.

    Cause

    API throttling limits restrict the frequency of calls to the endpoint /learning/odatav4/public/admin/user-service/v2/AI_mergeUser.

    Resolution

    1. Ensure API calls to /learning/odatav4/public/admin/user-service/v2/AI_mergeUser are spaced at least 5 minutes;
    2. Adhere to the monthly cap of 5000 merges, which applies to the combined total of API calls and bulk merges through the import tool;
    3. Confirm that the limits are consistent across all environments (production and non-production);
    4. Refer to the following documentation for additional guidance:

    Frequently asked questions: 

    Q1. How often can the API be called?
    A1. This API can be called once every 5 minutes.

    Q2. Is there a cap on the total number of merges allowed?
    A2. Yes. There is a monthly cap of 5000 merges in total. This limit applies to the sum of merges performed via API calls and bulk merges through the import tool.

    Q3. Do cumulative monthly limits apply to both API calls and bulk imports?
    A3. Yes. The 5000 merges per month limit applies to both methods combined (API + import tool).

    Q4. Are there differences in throttling or limits across environments (Sandbox vs. Production)?
    A4. No. The limits are the same across environment types.

    See Also

    Keywords

    429 error, rate, limiting, throttling, limits, merge, operations, SAP SuccessFactors Learning, odatav4/public/admin/user-service/v2/AI_mergeUser, TOO_MANY_REQUESTS, API calling limit, exceeded, bulk, monthly cap, API, guidelines. , KBA , LOD-SF-LMS-ODA , Web Services OData , Problem

    Product

    SAP SuccessFactors Learning all versions