On this page

Okta Aerial API release notes (2026)

RSS Subscribe to RSS

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.