OCI journey - OIE upgrade: API changes guide#6205
Conversation
brentschaus-okta
requested review from
barbaravo-okta,
emikhasyak-okta,
grahamsmith-okta,
ishan-krishna-okta,
janethu-okta,
paulwallace-okta and
susanharper-okta
as code owners
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
Add inbound links to the new "API changes after the upgrade" guide from the Identity Engine limitations guide, the Authentication API reference, and the Classic Engine MFA and session-cookie guides.
Acrolinx scoreA minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Successfully checked 6 of 6 documents. Reopen the pull request or push new changes to check again. Depending on the Acrolinx server configuration, the |
Acrolinx scoreA minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Successfully checked 6 of 6 documents. Reopen the pull request or push new changes to check again. Depending on the Acrolinx server configuration, the |
grahamsmith-okta
left a comment
grahamsmith-okta
left a comment
There was a problem hiding this comment.
a few notes and questions
…ndex.md Co-authored-by: grahamsmith-okta <graham.smith@okta.com>
…es/main/index.md Co-authored-by: grahamsmith-okta <graham.smith@okta.com>
Acrolinx scoreA minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Successfully checked 6 of 6 documents. Reopen the pull request or push new changes to check again. Depending on the Acrolinx server configuration, the |
Acrolinx scoreA minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Successfully checked 6 of 6 documents. Reopen the pull request or push new changes to check again. Depending on the Acrolinx server configuration, the |
…1185560) Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Acrolinx scoreA minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Successfully checked 6 of 6 documents. Reopen the pull request or push new changes to check again. Depending on the Acrolinx server configuration, the |
Acrolinx scoreA minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Successfully checked 6 of 6 documents. Reopen the pull request or push new changes to check again. Depending on the Acrolinx server configuration, the |
…-1185560) Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Acrolinx scoreA minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Successfully checked 6 of 6 documents. Reopen the pull request or push new changes to check again. Depending on the Acrolinx server configuration, the |
2 participants
Description
What's changed?
Adds a new API changes after the upgrade guide (
/docs/guides/oie-upgrade-api-changes/main/) documenting how specific Okta APIs behave differently or are unsupported after upgrading from Classic Engine to Identity Engine. Cross-links from related existing docs route readers to the new guide where relevant.New guide: API changes after the upgrade
Covers three API areas with a summary table, per-section migration guidance, and an update checklist:
audienceparameter not supported; device token behavior changed (migration path table)cookieTokenadditional field not supported;/api/v1/sessions/meno longer returns IdP informationCross-links added to related docs
docs/guides/ie-limitations/): Added an intro Note pointing to the new guide, plus per-section Further information links for email reset, question reset, Sessions APIs, SMS factors, theaudienceparameter, and password recovery.docs/reference/api/authn/): Linked thedeviceTokencaution to the new guide's device token section; added an Identity Engine note at the IdP-initiated step-up section for theaudienceparameter; added a note at the Recovery operations section for Classic password recovery limitations. Also fixed a stray trailing>typo in thedeviceTokencaution.docs/guides/mfa/): Added a Factors API changes link to the existing "If you're using Identity Engine" note.docs/guides/session-cookie/): Added the Sessions API changes link alongside the existing session references.Policy terminology fixes
Corrected mixed/incorrect policy names in both files:
ie-limitations: Changed "Okta sign-on policy" (Classic name used in an Identity Engine context) to "global session policy (called the Okta sign-on policy in Classic Engine)."oie-upgrade-api-changes: Changed "Classic global sign-on policy" (not a real product term) to "Okta sign-on policy (called the global session policy in Identity Engine)."Navbar and guide registry
oie-upgrade-api-changestoguides/index.mdnavbar.const.js(placed after Identity Engine limitations, before the event hooks entry)Is this PR related to a Monolith release?
No. Targeting the July monthly developer docs release (code freeze June 26, 2026.07.0).
Resolves
Netlify preview link
Preview link