OpenAPI Spec has 6 structural errors and fails validation

[mraible]

Describe the bug?

I used the OpenAPI spec from this repository in a blog post I published for CrowdStrike last year:

https://raw.githubusercontent.com/okta/okta-sdk-java/refs/heads/master/src/swagger/api.yaml

You can see the blog post at:

https://www.crowdstrike.com/tech-hub/ng-siem/create-custom-actions-for-soar-with-falcon-foundry/

I'm now trying to make a video about importing this spec, but when I run npx @redocly/cli lint api.yaml, there are 6 structural errors and 1,218 warnings.

Structural Errors

1. Line 70191-70192 - OAuth2ClientJsonSigningKeyRequest has discriminator properties (propertyName, mapping) incorrectly nested inside properties instead of at the schema level

2. Line 70196 - required field is incorrectly placed inside properties instead of at the schema level (should be a sibling to properties, not nested inside it)

3. Lines 64853, 64855 - EnhancedDynamicNetworkZone schema has include and exclude properties defined as arrays instead of proper schema objects:

   # Current (incorrect):
   include:
     - $ref: '#/components/schemas/NetworkZoneLocationArray'
   
   # Should be:
   include:
     $ref: '#/components/schemas/NetworkZoneLocationArray'

4. Line 70290 - Typo: nullabe should be nullable

What is expected to happen?

https://raw.githubusercontent.com/okta/okta-sdk-java/refs/heads/master/src/swagger/api.yaml should be a valid OpenAPI specification that passes validation.

What is the actual behavior?

❌ Validation failed with 6 errors and 1218 warnings.

Reproduction Steps?

curl -O https://raw.githubusercontent.com/okta/okta-sdk-java/refs/heads/master/src/swagger/api.yaml
npx @redocly/cli lint api.yaml

Additional Information?

This is a follow-up to #1604 which was fixed previously. We have many joint customers that want to use this OpenAPI spec with Falcon Foundry. Thanks!

Java Version

There's no Java involved in this issue.

SDK Version

Latest (as of 2026-02-03)

OS version

N/A