AsyncAPI Best Practices

asyncapi-payload-unsupported-schemaFormat

general > asyncapi-payload-unsupported-schemaFormat


Guidance

AsyncAPI can support various schemaFormat values. When unspecified, one of the following will be assumed:
application/vnd.aai.asyncapi;version=2.0.0 application/vnd.aai.asyncapi+json;version=2.0.0
application/vnd.aai.asyncapi+yaml;version=2.0.0

Message

The schemaFormat value '{{apiContract.schemaMediaType}}' is not supported by AsyncAPI.

Examples

valid

channels:
  myChannel:
    publish:
      message:
        payload:
          type: object
          properties:
            myProperty:
              type: string
        schemaFormat: "application/vnd.aai.asyncapi+json;version=2.0.0"

invalid

channels:
  myChannel:
    publish:
      message:
        payload:
          type: object
          properties:
            myProperty:
              type: string
        schemaFormat: "application/somerandomschema;version=2.0.0"

Applies to Payload

Constraint

Type: Declarative Validation
TypeRuleset
OrganizationMuleSoft
Published by
Mulesoft Organization
Published onOct 26, 2026
Asset overview

Asset versions for 1.3.x

Asset versions
VersionActions
1.3.0

Tags