SHOULD

SHOULD prefer standard media type names

Response content SHOULD use a standard media type application/json or application/problem+json (required for problem schemas).

Invalid Example

'204':
  description: No Content
  content:
    application/xml:
      schema:
        type: object
        properties:
          name:
            type: string
          url:
            type: string
            format: uri-reference

Valid Example

'204':
  description: No Conten
  content:
    application/json:
      schema:
        type: object
        properties:
          name:
            type: string
          url:
            type: string
            format: uri-reference

Zalando Guideline 172

---

Published: 24 January 2025
Last updated: 14 August 2025
Page Source