ST-2026-008 · API endpoints & versions
Atlassian sets June 2027 cutoff for Cloud Admin get-users and get-groups APIs
Atlassian deprecated two Cloud Admin directory endpoints for listing users and groups and says they will stop working after 30 June 2027, with new V2 search APIs designated as the replacements.
Previous state
Cloud Admin integrations could enumerate organization directory users and groups through the existing get-users and get-groups endpoints under the documented /v2 paths.
Current state
Integrations should use the new Search users in an organization (v2) and Search groups in an organization (v2) APIs before the older get endpoints stop working.
Affected users
Who needs to care
Atlassian Cloud organization administrators, identity-governance tools and directory integrations calling the named users or groups endpoints.
Required response
What to do
Locate calls to the two deprecated endpoints, map query and pagination behavior to the new search APIs, test result differences, and deploy the replacement before the June 2027 cutoff.
Evidence boundary
What the source does not prove
Atlassian labels the change as a deprecation of “V1 Get users and Get groups” while displaying /v2 endpoint paths. SchemaTrace preserves both the publisher label and exact paths rather than resolving that naming inconsistency by inference.
Lifecycle history
Dated event sequence
- Deprecation announced
Atlassian identified the two existing endpoints and introduced new V2 search APIs for users and groups.
- Last supported date
The deprecated get-users and get-groups APIs are documented to stop working after this date.
Evidence ledger
First-party sources
- 01Atlassian Cloud Admin Changelog — V1 Get users and Get groups REST APIs deprecated
Official API changelog · 2026-07-02
Open official source ↗