# schema-format-unknown

Source: https://api-genie.dev/docs/linter/asyncapi/rules/schema-format-unknown

A rule of the AsyncAPI linter, which reads AsyncAPI 3 documents; the reader rejects AsyncAPI 2 documents. Since 0.10.0. In the rulesets: Strict at warning, All at warning.

This rule reports a `format` of an AsyncAPI document which is neither in the
[OpenAPI format registry](https://spec.openapis.org/registry/format/) nor
declared in `openapi.custom_formats` of the
[configuration file](/docs/reference/cli/configuration#openapicustom_formats).

## Rule details

Tools ignore formats they do not know, so a misspelled format (`date_time`,
`uuid4`) stops being checked without a word. Formats defined on purpose are declared
in the configuration file:

```yaml
openapi:
  custom_formats:
    - {name: currency-code, type: string}
```

The rule is off in the `recommended` ruleset and a warning in `strict` and
`all`. See [Formats](/docs/reference/cli/formats) for the registry's
formats.

Turn the rule off when the documents use many formats of their own and listing them in the
configuration file is not worth it.

## Examples

**Good**. `uuid` is in the registry.

```yaml
asyncapi: 3.0.0
info:
  title: Order Events
  version: 1.0.0
components:
  schemas:
    OrderId:
      type: string
      format: uuid
```

**Bad**. `uuid4` is not, so nothing checks the value.

```yaml
asyncapi: 3.0.0
info:
  title: Order Events
  version: 1.0.0
components:
  schemas:
    OrderId:
      type: string
      format: uuid4
```
