diff --git a/versions/3.1.1.md b/versions/3.1.1.md index 5563672e57..c1004d5434 100644 --- a/versions/3.1.1.md +++ b/versions/3.1.1.md @@ -2021,7 +2021,7 @@ $response.header.Location | https://example.org/subscription/1 ##### Callback Object Examples -The following example uses the user provided `queryUrl` query string parameter to define the callback URL. This is an example of how to use a callback object to describe a WebHook callback that goes with the subscription operation to enable registering for the WebHook. +The following example uses the user provided `queryUrl` query string parameter to define the callback URL. This is similar to a [webhook](#oasWebhooks), but differs in that the callback only occurs because of the initial request that sent the `queryUrl`. ```yaml myCallback: @@ -2587,10 +2587,12 @@ additionalProperties: "required": [ "name" ], - "example": { - "name": "Puma", - "id": 1 - } + "examples": [ + { + "name": "Puma", + "id": 1 + } + ] } ``` @@ -2604,8 +2606,8 @@ properties: type: string required: - name -example: - name: Puma +examples: +- name: Puma id: 1 ```