UserFactorActivateResponse schema missing fields (id, status, provider, created, lastUpdated, profile)

[florian-serraille]

Description

The UserFactorActivateResponse schema in the OpenAPI spec is missing most fields that the Okta API actually returns when activating a factor (POST /api/v1/users/{userId}/factors/{factorId}/lifecycle/activate).

The schema currently only defines factorType and _links, but the live API documentation correctly shows the full response including id, status, provider, vendorName, created, lastUpdated, profile, and _embedded.

This is a known regression

This exact issue was already reported and fixed in the Java SDK:

• Issue: Missing attributes for UserFactorApi.activateFactor() #1596
• Fix PR: OKTA-865011: Fix missing attributes for UserFactorApi.activateFactor() #1602
• Internal tracker: OKTA-865011
• Released in: okta-sdk-java v21.0.0

However, the fix was overwritten 10 months later by commit 086d8b6 ("Java SDK Refresh - v25.0.0", Dec 23 2025), which replaced src/swagger/api.yaml with a fresh copy of the upstream spec.

Since the upstream spec was never corrected, the fix was lost. I verified all published versions of this repository from 2024.06.1 through current and none include the missing fields.

Timeline on okta-sdk-java:

• 371fc51 (Feb 24, 2025): OKTA-865011 fix applied to src/swagger/api.yaml
• 086d8b6 (Dec 23, 2025): Java SDK Refresh v25.0.0, spec replaced, fix lost