Required Examples

provide-examples-on-parameters

general > provide-examples-on-parameters


Guidance / Message

Always include examples in parameters and headers.

Examples

valid

#%RAML 1.0
title: example api
version: 1.0.0
/events:
  get:
    queryParameters:
      organization:
            type: string
            example: Hello!
    responses:
      200:
        description: Ok!

invalid

#%RAML 1.0
title: example api
version: 1.0.0
/events:
  get:
    queryParameters:
      organization:
            type: string
    responses:
      200:
        description: Ok!

Applies to Parameter

Constraint

Type: Rego Validation
TypeRuleset
OrganizationMuleSoft
Published by
MuleSoft Organization
Published onOct 8, 2024
Asset overview

Asset versions for 1.1.x

Asset versions
VersionActions
1.1.1
1.1.0

Tags