MUST specify default response
Each operation MUST include a default error response that combines multiple errors.
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 example below contains only a 200 response.
responses:
...
get:
summary: Get User Info by User ID
tags: []
responses:
'200':
description: OK
Valid Example
The example below contains a 200 response and a default response that references the Problem errors file.
responses:
...
get:
summary: Get User Info by User ID
tags: []
responses:
'200':
description: OK
default:
description: User Not Found
content:
application/problem+json:
schema:
$ref: ../models/Problem.yaml
Published: 24 January 2025
Last updated: 2 July 2026
Page Source