KBEC-00525 - Limitation on User API Query in CloudBees CD/RO

Last Reviewed:2025-12-29()
1 minute readKnowledge base

Issue

Currently, when using the getUser API or viewing through the user interface in CloudBees CD/RO, there is a limitation that prevents fetching more than 1000 users. When attempting to exceed this limit, users encounter the following error:

java.lang.RuntimeException: Error [InvalidInteger]: 'maximum' must be between 1 and 1000 [where: maximum]
▼

This limitation affects both the API query and the UI, restricting the ability to manage or view large user directories effectively.

Environment

Resolution

No permanent fix is available at this time. The issue is acknowledged by CloudBees and is under consideration for future enhancements. See Workaround below.

Workaround

To circumvent the current limitation, users can employ the findObjects API call within the DSL IDE to fetch more users than the getUser API allows.

  1. Open your DSL IDE.

  2. Execute the following command to retrieve up to 10,000 users:

    findObjects(objectType: "user", maxIds: 10000)
This workaround is temporary until the user query limit is expanded or otherwise resolved in a future product release.
This article is part of our Knowledge Base and is provided for guidance-based purposes only. The solutions or workarounds described here are not officially supported by CloudBees and may not be applicable in all environments. Use at your own discretion, and test changes in a safe environment before applying them to production systems.