Skip to content

Commit 9b49821

Browse files
committed
Mention the format registry in the data types section
1 parent 4cdcab3 commit 9b49821

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

versions/3.0.4.md

+2
Original file line numberDiff line numberDiff line change
@@ -182,6 +182,8 @@ Models are defined using the [Schema Object](#schemaObject), which is an extende
182182
OAS uses several known formats to define in fine detail the data type being used.
183183
However, to support documentation needs, the `format` property is an open `string`-valued property, and can have any value.
184184
Formats such as `"email"`, `"uuid"`, and so on, MAY be used even though they are not defined by this specification.
185+
The OpenAPI Initiative also hosts a [Format Registry](https://spec.openapis.org/registry/format/) for formats defined by OAS users and other specifications. Support for any registry format is strictly OPTIONAL, and support for one registry format does not imply support for any others.
186+
185187
Types that are not accompanied by a `format` property follow the type definition in the JSON Schema. Tools that do not recognize a specific `format` MAY default back to the `type` alone, as if the `format` is not specified.
186188

187189
The formats defined by the OAS are:

0 commit comments

Comments
 (0)