Repository navigation
openapi schema validation errors #499
Copy link
Copy link
Open
Labels
bugSomething isn't workingSomething isn't workingdocumentationImprovements or additions to documentationImprovements or additions to documentationquestionFurther information is requestedFurther information is requestedreproReproduced; investigation details recorded in LinearReproduced; investigation details recorded in LinearspecificationOpenAPI contract, authored schema, or specification publication defects.OpenAPI contract, authored schema, or specification publication defects.
Description
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
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
bugSomething isn't workingSomething isn't workingdocumentationImprovements or additions to documentationImprovements or additions to documentationquestionFurther information is requestedFurther information is requestedreproReproduced; investigation details recorded in LinearReproduced; investigation details recorded in LinearspecificationOpenAPI contract, authored schema, or specification publication defects.OpenAPI contract, authored schema, or specification publication defects.
Activity
markstuart-oai commentedon Sep 22, 2026
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.
markstuart-oai commentedon Sep 23, 2026
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 Stringexception is separate: OpenAPI Generator 7.16.0 produces it wheninvokerPackageis a Boolean. Set that option to a package-name string, such ascom.example.client. That addresses this configuration error, not the remaining specification errors.