Defect reference
Public codes and recovery guidance for Doctorine defect intelligence.
Each public defect code has one stable reference page. Use the code shown in a run to find its classification and available recovery guidance.
API specification
- Your spec is not valid JSON
spec.syntax.invalid-json - Your spec is not valid YAML
spec.syntax.invalid-yaml - Your spec file has an unsupported encoding
spec.syntax.encoding - A key appears twice in the same object
spec.syntax.duplicate-key - A numeric literal cannot be represented
spec.syntax.numeric-literal-unsupported - The spec entry file is missing
spec.entry.missing - Unsupported OpenAPI version
spec.version.unsupported - A keyword conflicts with your declared version
spec.version.keyword-incompatible - A reserved key is used in the document
spec.structure.reserved-key - Your spec exceeds a document size budget
spec.limits.document-budget - A reference cycle was kept as-is
spec.refs.cycle-preserved - A reference cycle cannot be resolved
spec.refs.cycle-unresolvable - A local $ref points at nothing
spec.refs.unresolved-local - A nested $ref could not be resolved
spec.refs.unresolved - A lint problem was found in your spec
spec.lint.problem - Your spec fails OpenAPI schema validation
spec.schema.invalid - An allOf combination cannot be merged
spec.schema.allof-conflict - Nullable is expressed in a legacy style
spec.schema.nullable-style - An enum has no declared type
spec.schema.untyped-enum - A response key uses a lowercase wildcard
spec.schema.response-key-style - An operation has no operationId
spec.operation.operation-id-missing - Two operations share the same operationId
spec.operation.operation-id-duplicate - allowReserved sits on a non-query parameter
spec.operation.allow-reserved-misplaced - Some operations have no summary
spec.operation.summary-missing - A path parameter is not declared
spec.operation.path-parameter-undeclared - A parameter location is not supported
spec.operation.parameter-location-unsupported - Your spec declares no servers
spec.servers.missing - An auth scheme cannot be modeled
spec.auth.unsupported-scheme - Your spec declares no securitySchemes
spec.auth.security-schemes-missing - Streaming config does not match the spec
spec.streaming.mismatch - The parameter serialization is unsupported
spec.operation.parameter-serialization-unsupported - The parameter content encoding is unsupported
spec.operation.parameter-content-unsupported
Processing limits
SDK configuration
- doctorine.sdk.yml is not valid YAML
config.syntax.invalid-yaml - doctorine.sdk.yml is too large
config.limits.size - doctorine.sdk.yml expands beyond its budget
config.limits.expansion - An unknown key is in your SDK config
config.schema.unrecognized-key - A config value is invalid
config.schema.invalid-value - A target cannot express this config
config.target.inexpressible - A referenced target is not declared
config.target.undeclared - A pagination scheme is not recognized
config.pagination.unknown-scheme - A pagination binding does not fit the operation
config.pagination.mismatch - A pagination binding could not be verified
config.pagination.unverified - An auth scheme is not recognized
config.auth.unknown-scheme - A configured auth scheme is not in your spec
config.auth.not-in-spec - Streaming operations need streaming config
config.streaming.missing - Environments were derived from the spec
config.environments.derived - Two error entries share a class name
config.errors.duplicate-class - A configured schema reference does not resolve
config.schema-ref.unknown - A resource method points at no operation
config.resources.unknown-operation - A resource method is ambiguous
config.resources.ambiguous-method - A client flag is nested where it cannot apply
config.resources.client-flag-nested - Your subset selects no operations
config.subset.empty - A subset selector matched nothing
config.subset.selector-unmatched - A pageable operation lacks its list sibling
config.subset.pagination-incomplete - A create operation lacks its get sibling
config.subset.resource-incomplete - A webhook payload type was dropped
config.subset.webhook-payload-dropped - Auth bootstrap happens outside your spec
config.subset.auth-bootstrap-external - A skill note matches nothing
config.skill.note-unmatched - An MCP operation override matches nothing
config.mcp.operation-unmatched - Operations excluded from the MCP server by configuration
config.mcp.operation-excluded - A skill note contains forbidden content
config.skill.note-forbidden-content
Generated naming
Operation coverage
Generated output
- Some types lost fidelity in this target
output.type-fidelity - MCP tools return plain results for streams
output.mcp.streaming-degraded - The skill teaches a raw-body path
output.skill.non-json-body-workaround - The skill streams via direct fetch
output.skill.streaming-direct-fetch - Code samples for an operation are stale
output.code-samples.stale - This operation kind has no code samples
output.code-samples.unsupported-operation-kind - Webhook signature verification was not emitted
output.webhook.verify-not-emitted - A webhook event could not be located
output.webhook.event-unlocatable - A webhook event name keys conflicting payloads
output.webhook.event-name-conflict - A union discriminator was inferred
output.union.discriminator-inferred - A union has no usable discriminator
output.union.discriminator-not-inferred - The schema pattern is unsupported
output.schema-pattern-unsupported - A generated example does not satisfy its schema
output.example-constraints-unresolved
Platform
- Generation failed on our side
platform.generation-failed - A warning we could not classify
platform.unclassified-warning - The artifact failed verification
platform.artifact-verification-failed - A quality note about the artifact
platform.artifact-quality-note - Our validator hit an internal problem
platform.validator-degraded - Our code-sample overlay was invalid
platform.code-sample-overlay-invalid