Skip to content

openapi schema validation errors #499

Open

Description

@evolgr

Hello all,

I am trying to load the OpenAI schema and generate API and model classes using the openapi-generator-maven-plugin for my project that uses mainly audio and realtime features, and we plan to use additional components soon.
During compilation, I am receiving many errors and warnings that eventually cause the build to fail.

...
[INFO] --- openapi-generator:7.16.0:generate (generate-openai-models) @ my-project ---
[ERROR] Undefined array inner type for `null`. Default to String.
[ERROR] Undefined array inner type for `null`. Default to String.
[WARNING] There were issues with the specification, but validation has been explicitly disabled.
Errors:
        -attribute components.schemas.EvalScoreModelGrader.max_items is unexpected
        -attribute components.schemas.TranscriptTextDeltaEvent.items is missing
        -attribute components.schemas.Eval.default is not of type `array`
        -attribute components.schemas.TranscriptionInclude.default is not of type `string`
        -attribute components.schemas.RealtimeTranscriptionSessionCreateRequest.default is not of type `string`
        -attribute components.schemas.VectorStoreFileAttributes.propertyNames is unexpected
        -attribute components.schemas.CreateTranscriptionResponseJson.optional is unexpected
        -paths.'/organization/certificates/{certificate_id}'. Declared path parameter certificate_id needs to be defined as a path parameter in path or operation level
        -attribute components.schemas.TranscriptTextDoneEvent.items is missing
        -attribute components.schemas.RealtimeSessionCreateRequest.default is not of type `string`
        -attribute components.schemas.CompoundFilter.$recursiveRef is unexpected
        -paths.'/organization/projects/{project_id}/certificates/activate'. Declared path parameter project_id needs to be defined as a path parameter in path or operation level
        -paths.'/organization/projects/{project_id}/certificates'. Declared path parameter project_id needs to be defined as a path parameter in path or operation level
        -attribute components.schemas.EvalScoreModelGrader.min_items is unexpected
        -attribute components.schemas.CompoundFilter.$recursiveAnchor is unexpected
        -attribute components.schemas.RealtimeSession.default is not of type `string`
        -paths.'/organization/projects/{project_id}/certificates/deactivate'. Declared path parameter project_id needs to be defined as a path parameter in path or operation level
Warnings:
        -Unused model: RealtimeServerEventResponseDone
        -Unused model: OutputAudio
        -Unused model: MessageDeltaContentTextObject
        -Unused model: RealtimeServerEventResponseOutputItemAdded
        -Unused model: RunStepDeltaStepDetailsToolCallsFunctionObject
        -Unused model: RealtimeClientEventSessionUpdate
        -Unused model: RealtimeServerEventConversationItemInputAudioTranscriptionFailed
        -Unused model: FineTunePreferenceRequestInput
        -Unused model: RunStepDeltaStepDetailsToolCallsFileSearchObject
        -Unused model: ModelIds
        -Unused model: RealtimeConversationItem
        -Unused model: BatchRequestOutput
        -Unused model: RealtimeServerEventResponseOutputItemDone
        -Unused model: RealtimeServerEventResponseTextDelta
        -Unused model: RealtimeServerEventConversationItemInputAudioTranscriptionCompleted
        -Unused model: BatchRequestInput
        -Unused model: LogProbProperties
        -Unused model: RealtimeClientEventInputAudioBufferClear
        -Unused model: RealtimeServerEventInputAudioBufferCleared
        -Unused model: RealtimeResponseCreateParams
        -Unused model: RealtimeServerEvent
        -Unused model: RealtimeServerEventConversationCreated
        -Unused model: RealtimeServerEventError
        -Unused model: RunStepDeltaStepDetailsMessageCreationObject
        -Unused model: RealtimeClientEventConversationItemCreate
        -Unused model: ChatCompletionRole
        -Unused model: ErrorEvent
        -Unused model: MessageDeltaContentImageUrlObject
        -Unused model: RunStepDeltaStepDetailsToolCallsObject
        -Unused model: RealtimeClientEventConversationItemRetrieve
        -Unused model: RealtimeClientEventInputAudioBufferCommit
        -Unused model: RealtimeServerEventOutputAudioBufferCleared
        -Unused model: RealtimeClientEventConversationItemTruncate
        -Unused model: MessageDeltaContentTextAnnotationsFilePathObject
        -Unused model: RealtimeServerEventInputAudioBufferCommitted
        -Unused model: RealtimeClientEventInputAudioBufferAppend
        -Unused model: RealtimeServerEventConversationItemCreated
        -Unused model: RealtimeServerEventTranscriptionSessionUpdated
        -Unused model: RunStepDeltaObject
        -Unused model: AssistantStreamEvent
        -Unused model: RunStepDeltaStepDetailsToolCallsCodeObject
        -Unused model: ThreadStreamEvent
        -Unused model: RealtimeServerEventResponseTextDone
        -Unused model: Content
        -Unused model: DoneEvent
        -Unused model: RealtimeServerEventInputAudioBufferSpeechStarted
        -Unused model: MessageDeltaContentRefusalObject
        -Unused model: RealtimeServerEventResponseContentPartDone
        -Unused model: RealtimeServerEventConversationItemRetrieved
        -Unused model: RunStepDeltaStepDetailsToolCallsCodeOutputLogsObject
        -Unused model: RealtimeClientEventResponseCancel
        -Unused model: RealtimeServerEventResponseCreated
        -Unused model: MessageDeltaObject
        -Unused model: RealtimeServerEventResponseAudioTranscriptDone
        -Unused model: RealtimeServerEventSessionUpdated
        -Unused model: FineTuneCompletionRequestInput
        -Unused model: RealtimeClientEventTranscriptionSessionUpdate
        -Unused model: RunStepStreamEvent
        -Unused model: RealtimeServerEventResponseAudioDelta
        -Unused model: RealtimeServerEventResponseAudioTranscriptDelta
        -Unused model: RealtimeResponse
        -Unused model: RealtimeServerEventInputAudioBufferSpeechStopped
        -Unused model: RealtimeServerEventConversationItemTruncated
        -Unused model: MessageDeltaContentTextAnnotationsFileCitationObject
        -Unused model: RealtimeClientEventResponseCreate
        -Unused model: RealtimeConversationItemWithReference
        -Unused model: ChatCompletionModalities
        -Unused model: FineTuneChatCompletionRequestAssistantMessage
        -Unused model: RealtimeServerEventRateLimitsUpdated
        -Unused model: RealtimeClientEventOutputAudioBufferClear
        -Unused model: FineTuneChatRequestInput
        -Unused model: MessageStreamEvent
        -Unused model: RealtimeServerEventResponseAudioDone
        -Unused model: MessageDeltaContentImageFileObject
        -Unused model: RealtimeServerEventConversationItemDeleted
        -Unused model: RealtimeServerEventSessionCreated
        -Unused model: RealtimeServerEventResponseContentPartAdded
        -Unused model: InputAudio
        -Unused model: RealtimeServerEventOutputAudioBufferStarted
        -Unused model: RealtimeServerEventOutputAudioBufferStopped
        -Unused model: RunStreamEvent
        -Unused model: RealtimeServerEventConversationItemInputAudioTranscriptionDelta
        -Unused model: RealtimeClientEventConversationItemDelete
        -Unused model: RealtimeServerEventResponseFunctionCallArgumentsDone
        -Unused model: RealtimeServerEventResponseFunctionCallArgumentsDelta
        -Unused model: RealtimeSession
        -Unused model: RunStepDeltaStepDetailsToolCallsCodeOutputImageObject
        -Unused model: RealtimeClientEvent

[INFO] Generating with dryRun=false
[INFO] Output directory (...\target\generated-sources\openapi) does not exist, or is inaccessible. No file (.openapi-generator-ignore) will be evaluated.
[INFO] OpenAPI Generator: java (client)
[INFO] Generator 'java' is considered stable.
[INFO] Environment variable JAVA_POST_PROCESS_FILE not defined so the Java code may not be properly formatted. To define it, try 'export JAVA_POST_PROCESS_FILE="/usr/local/bin/clang-format -i"' (Linux/Mac)
[INFO] NOTE: To enable file post-processing, 'enablePostProcessFile' must be set to `true` (--enable-post-process-file for CLI).
[WARNING] ...\src\main\resources\schemas\openai-api-2.3.0.yaml [0:0]: unexpected error in Open-API generation
java.lang.ClassCastException: class java.lang.Boolean cannot be cast to class java.lang.String (java.lang.Boolean and java.lang.String are in module java.base of loader 'bootstrap')
    at org.openapitools.codegen.languages.AbstractJavaCodegen.processOpts (AbstractJavaCodegen.java:449)
    at org.openapitools.codegen.languages.JavaClientCodegen.processOpts (JavaClientCodegen.java:343)
    at org.openapitools.codegen.DefaultGenerator.configureGeneratorProperties (DefaultGenerator.java:251)
    at org.openapitools.codegen.DefaultGenerator.generate (DefaultGenerator.java:1276)
    at org.openapitools.codegen.plugin.CodeGenMojo.execute (CodeGenMojo.java:1005)
    at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo (DefaultBuildPluginManager.java:126)
    at org.apache.maven.lifecycle.internal.MojoExecutor.doExecute2 (MojoExecutor.java:328)
    at org.apache.maven.lifecycle.internal.MojoExecutor.doExecute (MojoExecutor.java:316)
    at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:212)
    at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:174)
    at org.apache.maven.lifecycle.internal.MojoExecutor.access$000 (MojoExecutor.java:75)
    at org.apache.maven.lifecycle.internal.MojoExecutor$1.run (MojoExecutor.java:162)
    at org.apache.maven.plugin.DefaultMojosExecutionStrategy.execute (DefaultMojosExecutionStrategy.java:39)
    at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:159)
    at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject (LifecycleModuleBuilder.java:105)
    at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject (LifecycleModuleBuilder.java:73)
    at org.apache.maven.lifecycle.internal.builder.singlethreaded.SingleThreadedBuilder.build (SingleThreadedBuilder.java:53)
    at org.apache.maven.lifecycle.internal.LifecycleStarter.execute (LifecycleStarter.java:118)
    at org.apache.maven.DefaultMaven.doExecute (DefaultMaven.java:261)
    at org.apache.maven.DefaultMaven.doExecute (DefaultMaven.java:173)
    at org.apache.maven.DefaultMaven.execute (DefaultMaven.java:101)
    at org.apache.maven.cli.MavenCli.execute (MavenCli.java:906)
    at org.apache.maven.cli.MavenCli.doMain (MavenCli.java:283)
    at org.apache.maven.cli.MavenCli.main (MavenCli.java:206)
    at jdk.internal.reflect.DirectMethodHandleAccessor.invoke (DirectMethodHandleAccessor.java:103)
    at java.lang.reflect.Method.invoke (Method.java:580)
    at org.codehaus.plexus.classworlds.launcher.Launcher.launchEnhanced (Launcher.java:255)
    at org.codehaus.plexus.classworlds.launcher.Launcher.launch (Launcher.java:201)
    at org.codehaus.plexus.classworlds.launcher.Launcher.mainWithExitCode (Launcher.java:361)
    at org.codehaus.plexus.classworlds.launcher.Launcher.main (Launcher.java:314)
[ERROR]
java.lang.ClassCastException: class java.lang.Boolean cannot be cast to class java.lang.String (java.lang.Boolean and java.lang.String are in module java.base of loader 'bootstrap')
    at org.openapitools.codegen.languages.AbstractJavaCodegen.processOpts (AbstractJavaCodegen.java:449)
    at org.openapitools.codegen.languages.JavaClientCodegen.processOpts (JavaClientCodegen.java:343)
    at org.openapitools.codegen.DefaultGenerator.configureGeneratorProperties (DefaultGenerator.java:251)
    at org.openapitools.codegen.DefaultGenerator.generate (DefaultGenerator.java:1276)
    at org.openapitools.codegen.plugin.CodeGenMojo.execute (CodeGenMojo.java:1005)
    at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo (DefaultBuildPluginManager.java:126)
    at org.apache.maven.lifecycle.internal.MojoExecutor.doExecute2 (MojoExecutor.java:328)
    at org.apache.maven.lifecycle.internal.MojoExecutor.doExecute (MojoExecutor.java:316)
    at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:212)
    at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:174)
    at org.apache.maven.lifecycle.internal.MojoExecutor.access$000 (MojoExecutor.java:75)
    at org.apache.maven.lifecycle.internal.MojoExecutor$1.run (MojoExecutor.java:162)
    at org.apache.maven.plugin.DefaultMojosExecutionStrategy.execute (DefaultMojosExecutionStrategy.java:39)
    at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:159)
    at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject (LifecycleModuleBuilder.java:105)
    at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject (LifecycleModuleBuilder.java:73)
    at org.apache.maven.lifecycle.internal.builder.singlethreaded.SingleThreadedBuilder.build (SingleThreadedBuilder.java:53)
    at org.apache.maven.lifecycle.internal.LifecycleStarter.execute (LifecycleStarter.java:118)
    at org.apache.maven.DefaultMaven.doExecute (DefaultMaven.java:261)
    at org.apache.maven.DefaultMaven.doExecute (DefaultMaven.java:173)
    at org.apache.maven.DefaultMaven.execute (DefaultMaven.java:101)
    at org.apache.maven.cli.MavenCli.execute (MavenCli.java:906)
    at org.apache.maven.cli.MavenCli.doMain (MavenCli.java:283)
    at org.apache.maven.cli.MavenCli.main (MavenCli.java:206)
    at jdk.internal.reflect.DirectMethodHandleAccessor.invoke (DirectMethodHandleAccessor.java:103)
va:361)
    at org.codehaus.plexus.classworlds.launcher.Launcher.main (Launcher.java:314)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  7.348 s
[INFO] Finished at: 2025-10-23T17:43:45+03:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.openapitools:openapi-generator-maven-plugin:7.16.0:generate (generate-openai-models) on project my-project: Code generation failed. See above for the full exception. -> [Help 1]
[ERROR]
va:361)
    at org.codehaus.plexus.classworlds.launcher.Launcher.main (Launcher.java:314)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  7.348 s
[INFO] Finished at: 2025-10-23T17:43:45+03:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.openapitools:openapi-generator-maven-plugin:7.16.0:generate (generate-openai-models) on project my-project: Code generation failed. See above for the full exception. -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[INFO] Total time:  7.348 s
[INFO] Finished at: 2025-10-23T17:43:45+03:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.openapitools:openapi-generator-maven-plugin:7.16.0:generate (generate-openai-models) on project my-project: Code generation failed. See above for the full exception. -> [Help 1]
[ERROR]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException

After loading the schema manual_spec openai schema to swagger.io, I noticed several issues.

Errors
 
Semantic error at paths./organization/certificates/{certificate_id}
Declared path parameter "certificate_id" needs to be defined as a path parameter at either the path or operation level
Jump to line 7453

Semantic error at paths./organization/certificates/{certificate_id}.get.parameters.0.name
Path parameter "cert_id" must have the corresponding {cert_id} segment in the "/organization/certificates/{certificate_id}" path
Jump to line 7463

Semantic error at paths./organization/projects/{project_id}/certificates
Declared path parameter "project_id" needs to be defined as a path parameter at either the path or operation level
Jump to line 8321

Semantic error at paths./organization/projects/{project_id}/certificates/activate
Declared path parameter "project_id" needs to be defined as a path parameter at either the path or operation level
Jump to line 8395

Semantic error at paths./organization/projects/{project_id}/certificates/deactivate
Declared path parameter "project_id" needs to be defined as a path parameter at either the path or operation level
Jump to line 8462

Structural error at components.schemas.CompoundFilter
should NOT have additional properties
additionalProperty: $recursiveAnchor
Jump to line 18832

Structural error at components.schemas.CompoundFilter.properties.filters.items.oneOf.1
should NOT have additional properties
additionalProperty: $recursiveRef
Jump to line 18852

Structural error at components.schemas.CreateTranscriptionResponseJson.properties.logprobs
should NOT have additional properties
additionalProperty: optional
Jump to line 22675

Structural error at components.schemas.EvalScoreModelGrader.properties.range.items
should NOT have additional properties
additionalProperty: min_items, max_items
Jump to line 24595

Semantic error at components.schemas.TranscriptTextDeltaEvent.properties.logprobs.items.properties.bytes
Schemas with 'type: array', require a sibling 'items: ' field
Jump to line 36558

Semantic error at components.schemas.TranscriptTextDoneEvent.properties.logprobs.items.properties.bytes
Schemas with 'type: array', require a sibling 'items: ' field
Jump to line 36609

Semantic error at components.schemas.TranscriptionInclude.default
Default values must be present in `enum`
Jump to line 36628

Structural error at components.schemas.VectorStoreFileAttributes
should NOT have additional properties
additionalProperty: propertyNames
Jump to line 37471

Structural error at components.schemas.InputImageContent.properties.image_url.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38078

Structural error at components.schemas.InputImageContent.properties.file_id.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38083

Structural error at components.schemas.InputFileContent.properties.file_id.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38112

Structural error at components.schemas.RankingOptions.required
should NOT have fewer than 1 items
limit: 1
Jump to line 38139

Structural error at components.schemas.FileSearchTool.properties.filters.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38169

Structural error at components.schemas.FunctionTool.properties.description.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38195

Structural error at components.schemas.FunctionTool.properties.parameters.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38201

Structural error at components.schemas.FunctionTool.properties.strict.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38206

Structural error at components.schemas.ApproximateLocation.properties.country.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38232

Structural error at components.schemas.ApproximateLocation.properties.region.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38237

Structural error at components.schemas.ApproximateLocation.properties.city.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38242

Structural error at components.schemas.ApproximateLocation.properties.timezone.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38249

Structural error at components.schemas.WebSearchPreviewTool.properties.user_location.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38267

Structural error at components.schemas.ComputerCallSafetyCheckParam.properties.code.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38435

Structural error at components.schemas.ComputerCallSafetyCheckParam.properties.message.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38440

Structural error at components.schemas.ComputerCallOutputItemParam.properties.id.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38451

Structural error at components.schemas.ComputerCallOutputItemParam.properties.acknowledged_safety_checks.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38474

Structural error at components.schemas.ComputerCallOutputItemParam.properties.status.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38485

Structural error at components.schemas.FunctionCallOutputItemParam.properties.id.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38500

Structural error at components.schemas.FunctionCallOutputItemParam.properties.status.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38527

Structural error at components.schemas.ItemReferenceParam.properties.type.anyOf.1.type
should be equal to one of the allowed values
allowedValues: array, boolean, integer, number, object, string
Jump to line 38545

After validating the schema using the OAS validation check, I am again seeing multiple problems.

Context: Path: /organization/certificates/{certificate_id}, Method: GET
Example:
cert_id
Error: Path parameter 'cert_id' is declared but not present in the URL.

Context: Schema: TranscriptionInclude
Example:
[]
Error: Default value is not present in the enum list.

Context: Schema: CreateEvalCustomDataSourceConfig, Property: item_schema
Example:
{
  "type": "object",
  "properties": {
    "name": {"type": "string"},
    "age": {"type": "integer"}
  },
  "required": ["name", "age"]
}
Error: '{\n "type": "object",\n "properties": {\n "name": {"type": "string"},\n "age": {"type": "integer"}\n },\n "required": ["name", "age"]\n}\n' is not of type 'object' Failed validating 'type' in schema: {'type': 'object', 'description': 'The json schema for each row in the data source.', 'additionalProperties': True, 'example': '{\n' ' "type": "object",\n' ' "properties": {\n' ' "name": {"type": "string"},\n' ' "age": {"type": "integer"}\n' ' },\n' ' "required": ["name", "age"]\n' '}\n'} On instance: ('{\n' ' "type": "object",\n' ' "properties": {\n' ' "name": {"type": "string"},\n' ' "age": {"type": "integer"}\n' ' },\n' ' "required": ["name", "age"]\n' '}\n')

Context: Schema: CreateEvalLogsDataSourceConfig, Property: metadata
Example:
{
  "use_case": "customer_support_agent"
}
Error: '{\n "use_case": "customer_support_agent"\n}\n' is not of type 'object' Failed validating 'type' in schema: {'type': 'object', 'description': 'Metadata filters for the logs data source.', 'additionalProperties': True, 'example': '{\n "use_case": "customer_support_agent"\n}\n'} On instance: '{\n "use_case": "customer_support_agent"\n}\n'

Context: Schema: EvalCustomDataSourceConfig, Property: schema
Example:
{
  "type": "object",
  "properties": {
    "item": {
      "type": "object",
      "properties": {
        "label": {"type": "string"},
      },
      "required": ["label"]
    }
  },
  "required": ["item"]
}
Error: '{\n "type": "object",\n "properties": {\n "item": {\n "type": "object",\n "properties": {\n "label": {"type": "string"},\n },\n "required": ["label"]\n }\n },\n "required": ["item"]\n}\n' is not of type 'object' Failed validating 'type' in schema: {'type': 'object', 'description': 'The json schema for the run data source items.\n' 'Learn how to build JSON schemas ' '[here](https://json-schema.org/).\n', 'additionalProperties': True, 'example': '{\n' ' "type": "object",\n' ' "properties": {\n' ' "item": {\n' ' "type": "object",\n' ' "properties": {\n' ' "label": {"type": "string"},\n' ' },\n' ' "required": ["label"]\n' ' }\n' ' },\n' ' "required": ["item"]\n' '}\n'} On instance: ('{\n' ' "type": "object",\n' ' "properties": {\n' ' "item": {\n' ' "type": "object",\n' ' "properties": {\n' ' "label": {"type": "string"},\n' ' },\n' ' "required": ["label"]\n' ' }\n' ' },\n' ' "required": ["item"]\n' '}\n')

Is anyone else experiencing this issue?
Any suggestions or guidance on how to proceed will be greatly appreciated.

Best Regards,
Evaggelos

Activity

  1. added
    bugSomething isn't working
    specificationOpenAPI contract, authored schema, or specification publication defects.
    documentationImprovements or additions to documentation
    questionFurther information is requested
    on Sep 6, 2026
  2. markstuart-oai commented on Sep 22, 2026

    @markstuart-oai
    Contributor

    This report contains both specification errors and a separate Java generator configuration error. Fixing the Realtime defaults does not resolve all of them. See the current status and configuration guidance below.

  3. markstuart-oai commented on Sep 23, 2026

    @markstuart-oai
    Contributor

    Not fully fixed; this issue remains open.

    The published specification includes the Realtime array/default fix. It still has validation problems, including reserved extension names, the transcription default, grader-range constraints, and object examples stored as strings. We have reproduced the remaining problems and do not need another reproduction from you.

    The Boolean cannot be cast to String exception is separate: OpenAPI Generator 7.16.0 produces it when invokerPackage is a Boolean. Set that option to a package-name string, such as com.example.client. That addresses this configuration error, not the remaining specification errors.

  4. added
    reproReproduced; investigation details recorded in Linear
    on Sep 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

bugSomething isn't workingdocumentationImprovements or additions to documentationquestionFurther information is requestedreproReproduced; investigation details recorded in LinearspecificationOpenAPI contract, authored schema, or specification publication defects.

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions