DeprecatrAI

v2

Released 2021-07-22Active
← v1
Migration Effort
Low
Estimated Hours
~8h
Primary risk if skipped: Intermittent API errors if breaking changes are not addressed.

Breaking Changes2

endpointHighOkta Identity EngineOkta Classic

/api/v1/users/{user}/lifecycle/{action}

The /deactivate and /suspend lifecycle actions for users have been removed. These operations are now handled by the new /users/{user}/lifecycle/deactivate and /users/{user}/lifecycle/suspend endpoints, respectively.

Before
POST /api/v1/users/{user}/lifecycle/deactivate
After
POST /api/v1/users/{user}/lifecycle/deactivate
→

Update calls from POST /api/v1/users/{user}/lifecycle/{action} to POST /api/v1/users/{user}/lifecycle/{action}.

endpointMediumOkta Identity EngineOkta Classic

/api/v1/apps/{appId}/assignUser

The endpoint for assigning users to applications has been updated. The previous endpoint is no longer supported, and you should use the new endpoint structure for user assignments.

Before
POST /api/v1/apps/{appId}/assignUser
After
POST /api/v1/applications/{appId}/users
→

Update calls to assign users to applications to use the new endpoint structure: POST /api/v1/applications/{appId}/users.

Migration Checklist

Full interactive checklist →
  1. 1Review Okta API v2 release notes for all changes.
  2. 2Identify all endpoints in your integration that interact with user lifecycle management (deactivation, suspension).
  3. 3Update user lifecycle management API calls to use the new endpoint structure: POST /api/v1/users/{user}/lifecycle/{action}.
  4. 4Identify all endpoints related to assigning users to applications.
  5. 5Update application user assignment API calls to use the new endpoint: POST /api/v1/applications/{appId}/users.
  6. 6Test integration thoroughly in a staging environment after applying changes.
  7. 7Deploy updated integration to production.
  8. 8Monitor API error logs for any unexpected issues post-deployment.

Never get blindsided by an API change again

Deprecatr AI monitors 150+ providers, maps changes to your codebase, and delivers migration checklists before your team hits a breaking change.

Join the Waitlist