Skip to main content

Alpha This is a new service. Help us improve it and give your feedback.

MUST

MUST use problem json as default response

The content type for the default response MUST be application/problem+json.

Important:

For OpenAPI definitions marked with info.x-api-type: pygeoapi, the paired -pygeoapi sibling rule fires at warn instead. See 1.

Invalid Example

The default response in this example incorrectly uses application/json as the content type.

responses:
   ...
get:
  summary: Get User Info by User ID
   tags: []
   responses:
     ...
     default:
       description: ...
       content:
         application/json:
           schema:
             $ref: ../models/Problem.yaml

Valid Example

The default response in this example correctly uses application/problem+json as the content type.

responses:
   ...
get:
  summary: Get User Info by User ID
   tags: []
   responses:
     ...
     default:
       description: ...
       content:
         application/problem+json:
           schema:
             $ref: ../models/Problem.yaml

Zalando Guideline 151

Published: 24 January 2025
Last updated: 2 July 2026
Page Source