On this page
Okta Aerial API release notes (2026)
These release notes list customer-visible changes to the Okta Aerial API. Okta Aerial aligns with the Okta Classic Engine and Okta Identity Engine release, but updates to the Aerial service deploy from outside their release dates.
The Aerial services preview date represents expected updates to the preview environment (
https://aerial-sandbox.okta.com).The Aerial services production date represents expected updates to the production environment (
https://aerial-apac.okta.com).
See also Introduction to the Okta Aerial API (opens new window).
March
Monthly release
| Change | Expected in Aerial services preview | Expected in Aerial services production |
|---|---|---|
| Aerial Org Groups and Request Condition Template APIs | March 5, 2026 | March 11, 2026 |
| Aerial member role available in EA | March 5, 2026 | March 11, 2026 |
| Developer documentation update in 2026.03.0 | March 4, 2026 | March 4, 2026 |
Aerial Org Groups and Request Condition Template APIs
Previously, access request conditions for managed orgs could only be applied to all managed orgs using a template app or a single org from within its Aerial org's Admin Console. Now, you can create org groups and apply access request conditions to one or more managed orgs all from within the Aerial Console. To support this new flexible grouping and governance experience, Okta introduces a new suite of APIs that allow developers to programmatically manage Org Groups and apply access request conditions across multiple orgs at scale. These APIs help you define precise rules for access, streamlining governance and improving usability.
See the Org Groups (opens new window) and Governance (opens new window) APIs. For more information on managing Org Groups in the Aerial Console, see Create org groups (opens new window).
Aerial member role available in EA
Previously, all users were invited as Aerial Owners with super admin privileges. Now, they can be invited as Aerial members, providing lower-scope permissions. This enhances security by distinguishing true owners from members who need access for specific tasks, ensuring tighter control over Aerial workflows.
See Aerial members (opens new window).
Developer documentation update in 2026.03.0
Okta's API reference pages (opens new window) are undergoing a migration, which started on February 24. While the look and feel may vary across pages during this time, all technical documentation remains accurate and up to date.
February
Weekly release
| Change | Expected in Aerial services preview | Expected in Aerial services production |
|---|---|---|
| Bug fixed in 2026.02.3 | February 24, 2026 | March 2, 2026 |
Bug fixed in 2026.02.3
You could call the Apply an access request condition (opens new window) API with an invalid access condition. (OKTA-1091926)
Monthly release 2026.02.0
| Change | Expected in Preview Orgs |
|---|---|
| Developer documentation updates in 2026.02.0 | February 4, 2026 |
Developer documentation updates in 2026.02.0
The Okta developer portal search results now include the API references.
January
Weekly release
| Change | Expected in Aerial services preview | Expected in Aerial services production |
|---|---|---|
| Okta Aerial supports Identity Threat Protection with Okta AI | January 13, 2026 | January 20, 2026 |
| Developer documentation update | January 8, 2026 | January 8, 2026 |
Okta Aerial supports Identity Threat Protection with Okta AI
Okta Aerial now supports the enablement of Identity Threat Protection with Okta AI for managed orgs (IT Products - Identity Threat Protection). Use the Update enabled products for an org (opens new window) endpoint with the product ID P001113 to enable this product. See Enable products in the org (opens new window) and Identity Threat Protection with Okta AI (opens new window).
Developer documentation update
The Okta API release notes now provide an RSS feed for each API release note category: Classic Engine, Identity Engine, Identity Governance, Privileged Access, Access Gateway, and Aerial. Click the RSS icon to subscribe.