From cad81fd0ec2bd799f501ecda5141c700daa8fd87 Mon Sep 17 00:00:00 2001 From: Eivind Grimstad Date: Tue, 3 Mar 2026 14:38:38 +0100 Subject: [PATCH] fix: Add 201 as allowed response to PUT HTTP standard indicates that PUT can return 201: https://www.rfc-editor.org/rfc/rfc9110.html#name-put > If the target resource does not have a current representation and the PUT successfully creates one, then the origin server MUST inform the user agent by sending a 201 (Created) response. --- .spectral.yml | 2 +- guidelines.md | 28 ++++++++++++++-------------- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/.spectral.yml b/.spectral.yml index 16cbc43..c457287 100644 --- a/.spectral.yml +++ b/.spectral.yml @@ -440,7 +440,7 @@ rules: then: function: enumeration functionOptions: - values: ["200", "204", "400", "401", "403", "404", "409", "500", "503"] + values: ["200", "201", "204", "400", "401", "403", "404", "409", "500", "503"] entur-patch-responses-validation: message: "Invalid response code: {{property}}. PATCH responses MUST use one of these response codes: 200, 204, 400, 401, 403, 404, 409, 500, 503" diff --git a/guidelines.md b/guidelines.md index 45b6f42..6a579a6 100644 --- a/guidelines.md +++ b/guidelines.md @@ -304,20 +304,20 @@ Here, only 1 specification will be shown on the Developer Portal, which is a com - :white_check_mark: Request body is only allowed for PUT, POST and PATCH -| Code | Description | GET | POST | PUT | PATCH | DELETE | -|------|-----------------------|-----|------|-----|-------|--------| -| 200 | OK | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |:white_check_mark: | -| 201 | Created | | :white_check_mark: | | | | -| 202 | Accepted | | :white_check_mark: | | | | -| 204 | No Content | | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: | -| 303 | See Other | | :white_check_mark: | | | | -| 400 | Bad Request | :white_check_mark: | :white_check_mark: | :white_check_mark: |:white_check_mark: |:white_check_mark: | -| 401 | Unauthorized | :white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: -| 403 | Forbidden | :white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: -| 404 | Not Found | :white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: -| 409 | Conflict | | :white_check_mark: | :white_check_mark: |:white_check_mark: |:white_check_mark: | -| 500 | Internal Server Error | :white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: -| 503 | Service Unavailable | :white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: |:white_check_mark: +| Code | Description | GET | POST | PUT | PATCH | DELETE | +|------|-----------------------|------------------|------------------|------------------|------------------|------------------| +| 200 | OK |:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:| +| 201 | Created | |:white_check_mark:|:white_check_mark:| | | +| 202 | Accepted | |:white_check_mark:| | | | +| 204 | No Content | |:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:| +| 303 | See Other | |:white_check_mark:| | | | +| 400 | Bad Request |:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:| +| 401 | Unauthorized |:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:| +| 403 | Forbidden |:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:| +| 404 | Not Found |:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:| +| 409 | Conflict | |:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:| +| 500 | Internal Server Error |:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:| +| 503 | Service Unavailable |:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:| ### 4.2 Error Handling