Looking to master JSON Schema for OpenAPI?

A 9+ hour course taught by a member of the JSON Schema Technical Steering Committee

Take the Video Course Also check out our O'Reilly book

externalDocs : Object

externalDocs

Object

Points to an external resource that further documents the schema.

Value	This keyword must be set to an object that declares a `url` string and optionally a `description` string Hint: Use the `jsonschema metaschema` and `jsonschema lint` commands to catch keywords set to invalid values
Kind	Other
Applies To	Any
Base Dialect	2020-12
Changed In	None
Introduced In	OpenAPI 3.1
Vocabulary	OpenAPI 3.2
Specification	https://spec.openapis.org/oas/v3.2.1.html#schema-external-docs
Metaschema	https://spec.openapis.org/oas/3.2/meta/2026-02-26
Official Tests	None
Default	None
Annotation	None
Affected By	None
Affects	None
Also See	externalDocs (Vocabulary: OpenAPI 3.1) title (Vocabulary: Meta Data) description (Vocabulary: Meta Data) $comment (Vocabulary: Core)

Feeling stuck? Need expert help?

Sourcemeta, the company behind this site, offers world-class consultancy services in the JSON Schema ecosystem. We have extensive experience designing large-scale JSON Schema ontologies and data models, and OpenAPI Governance initiatives across industries. Reach out to discuss more!

Hint: You can also get free community help in the JSON Schema Slack and JSON Schema GitHub Discussions forum.