diff --git a/changelogs/client_server/newsfragments/1563.clarification b/changelogs/client_server/newsfragments/1563.clarification new file mode 100644 index 00000000..1d6ef324 --- /dev/null +++ b/changelogs/client_server/newsfragments/1563.clarification @@ -0,0 +1 @@ +Make sure examples types match schema in definitions. diff --git a/changelogs/identity_service/newsfragments/1563.clarification b/changelogs/identity_service/newsfragments/1563.clarification new file mode 100644 index 00000000..1d6ef324 --- /dev/null +++ b/changelogs/identity_service/newsfragments/1563.clarification @@ -0,0 +1 @@ +Make sure examples types match schema in definitions. diff --git a/changelogs/server_server/newsfragments/1563.clarification b/changelogs/server_server/newsfragments/1563.clarification new file mode 100644 index 00000000..1d6ef324 --- /dev/null +++ b/changelogs/server_server/newsfragments/1563.clarification @@ -0,0 +1 @@ +Make sure examples types match schema in definitions. diff --git a/data/api/client-server/message_pagination.yaml b/data/api/client-server/message_pagination.yaml index 940b9802..07c16497 100644 --- a/data/api/client-server/message_pagination.yaml +++ b/data/api/client-server/message_pagination.yaml @@ -84,7 +84,7 @@ paths: - in: query name: limit description: "The maximum number of events to return. Default: 10." - example: "3" + example: 3 schema: type: integer - in: query diff --git a/data/api/client-server/old_sync.yaml b/data/api/client-server/old_sync.yaml index 3e0ad0b6..540c97c7 100644 --- a/data/api/client-server/old_sync.yaml +++ b/data/api/client-server/old_sync.yaml @@ -44,7 +44,7 @@ paths: name: timeout description: The maximum time in milliseconds to wait for an event. required: false - example: "35000" + example: 35000 schema: type: integer responses: @@ -105,7 +105,7 @@ paths: name: limit description: The maximum number of messages to return for each room. required: false - example: "2" + example: 2 schema: type: integer - in: query @@ -116,7 +116,7 @@ paths: included. If set to `true` then rooms that the user has left are included as well. By default this is `false`. required: false - example: "true" + example: true schema: type: boolean responses: diff --git a/data/api/client-server/peeking_events.yaml b/data/api/client-server/peeking_events.yaml index 19eb67a0..b323d940 100644 --- a/data/api/client-server/peeking_events.yaml +++ b/data/api/client-server/peeking_events.yaml @@ -49,14 +49,13 @@ paths: name: timeout description: The maximum time in milliseconds to wait for an event. required: false - example: "35000" + example: 35000 schema: type: integer - in: query name: room_id description: The room ID for which events should be returned. - example: - - "!somewhere:over.the.rainbow" + example: "!somewhere:over.the.rainbow" schema: type: string responses: diff --git a/data/api/client-server/pushrules.yaml b/data/api/client-server/pushrules.yaml index 88013307..57638583 100644 --- a/data/api/client-server/pushrules.yaml +++ b/data/api/client-server/pushrules.yaml @@ -543,7 +543,7 @@ paths: required: true description: | The kind of rule - example: cake + example: content schema: type: string enum: diff --git a/data/api/client-server/sync.yaml b/data/api/client-server/sync.yaml index 0b22a96e..5e554722 100644 --- a/data/api/client-server/sync.yaml +++ b/data/api/client-server/sync.yaml @@ -84,7 +84,7 @@ paths: changed since the point indicated by `since` will be returned. By default, this is `false`. - example: "false" + example: false schema: type: boolean - in: query diff --git a/data/api/identity/v2_associations.yaml b/data/api/identity/v2_associations.yaml index 8ed4041a..c9b8ba6e 100644 --- a/data/api/identity/v2_associations.yaml +++ b/data/api/identity/v2_associations.yaml @@ -29,7 +29,7 @@ paths: name: sid description: The Session ID generated by the `requestToken` call. required: true - example: 1234 + example: "1234" schema: type: string - in: query diff --git a/data/api/identity/v2_email_associations.yaml b/data/api/identity/v2_email_associations.yaml index 0bd31b52..ad5c2517 100644 --- a/data/api/identity/v2_email_associations.yaml +++ b/data/api/identity/v2_email_associations.yaml @@ -186,7 +186,7 @@ paths: name: sid required: true description: The session ID, generated by the `requestToken` call. - example: 1234 + example: "1234" schema: type: string - in: query diff --git a/data/api/identity/v2_phone_associations.yaml b/data/api/identity/v2_phone_associations.yaml index f887be26..7f44fb3d 100644 --- a/data/api/identity/v2_phone_associations.yaml +++ b/data/api/identity/v2_phone_associations.yaml @@ -188,7 +188,7 @@ paths: name: sid required: true description: The session ID, generated by the `requestToken` call. - example: 1234 + example: "1234" schema: type: string - in: query diff --git a/data/api/identity/v2_terms.yaml b/data/api/identity/v2_terms.yaml index f4a45932..550d0bdb 100644 --- a/data/api/identity/v2_terms.yaml +++ b/data/api/identity/v2_terms.yaml @@ -131,7 +131,7 @@ paths: items: type: string description: The URLs the user is accepting in this request. - example: https://example.org/somewhere/terms-2.0-en.html + example: ["https://example.org/somewhere/terms-2.0-en.html"] required: - user_accepts responses: diff --git a/data/api/server-server/leaving-v2.yaml b/data/api/server-server/leaving-v2.yaml index 75248b53..b79ce008 100644 --- a/data/api/server-server/leaving-v2.yaml +++ b/data/api/server-server/leaving-v2.yaml @@ -109,7 +109,6 @@ paths: - depth - content example: { - "room_id": "!somewhere:example.org", "type": "m.room.member", "state_key": "@someone:example.org", "origin": "example.org", @@ -117,7 +116,8 @@ paths: "sender": "@someone:example.org", "content": { "membership": "leave" - } + }, + "depth": 0 } required: true responses: