diff --git a/aep/general/0133/aep.md.j2 b/aep/general/0133/aep.md.j2 index ce0714b6..126a1820 100644 --- a/aep/general/0133/aep.md.j2 +++ b/aep/general/0133/aep.md.j2 @@ -90,8 +90,9 @@ Create methods implement a common request message pattern: {% tab oas %} -{% sample '../example.oas.yaml', '$.paths./publishers/{publisher_id}/books.post.responses.200' %} +{% sample '../example.oas.yaml', '$.paths./publishers/{publisher_id}/books.post.responses.201' %} +- The response **must** return a `201 Created` HTTP status code. - The response **must** be the resource itself. There is no separate response schema. - The response **should** include the fully-populated resource, and **must** diff --git a/aep/general/0137/aep.md.j2 b/aep/general/0137/aep.md.j2 index 684146d4..f0fae325 100644 --- a/aep/general/0137/aep.md.j2 +++ b/aep/general/0137/aep.md.j2 @@ -108,7 +108,7 @@ Apply methods implement a common request message pattern: {% tab oas %} -{% sample '../example.oas.yaml', '$.paths./publishers/{publisher_id}/books/{book_id}.put.responses.200' %} +{% sample '../example.oas.yaml', '$.paths./publishers/{publisher_id}/books/{book_id}.put.responses' %} - If the resource is created, the response **must** return a `201` status code. - If the resource is updated, the response **must** return a `200` status code. diff --git a/aep/general/example.oas.yaml b/aep/general/example.oas.yaml index e519e320..fb6a23ff 100644 --- a/aep/general/example.oas.yaml +++ b/aep/general/example.oas.yaml @@ -196,7 +196,7 @@ paths: $ref: '#/components/schemas/isbn' required: true responses: - '200': + '201': content: application/json: schema: @@ -269,7 +269,7 @@ paths: $ref: '#/components/schemas/publisher' required: true responses: - '200': + '201': content: application/json: schema: @@ -354,7 +354,13 @@ paths: application/json: schema: $ref: '#/components/schemas/publisher' - description: Successful response + description: Successful response (updated) + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/publisher' + description: Successful response (created) /publishers/{publisher_id}/books: get: description: List method for book @@ -411,7 +417,7 @@ paths: $ref: '#/components/schemas/book' required: true responses: - '200': + '201': content: application/json: schema: @@ -516,7 +522,13 @@ paths: application/json: schema: $ref: '#/components/schemas/book' - description: Successful response + description: Successful response (updated) + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/book' + description: Successful response (created) /publishers/{publisher_id}/books/{book_id}/editions: get: description: List method for book-edition @@ -579,7 +591,7 @@ paths: $ref: '#/components/schemas/book-edition' required: true responses: - '200': + '201': content: application/json: schema: