OneTimeKeys is not defined by the CS API spec

[DMRobertson]

Link to problem area: https://spec.matrix.org/unstable/client-server-api/#post_matrixclientv3keysupload

Issue
fallback_keys and one_time_keys are defined as OneTimeKeys. This type is not defined in the client-server spec.

There are no mandatory keys for OneTimeKeys. I expect this confuses our go template langauge machinery.

matrix-spec/data/api/client-server/definitions/one_time_keys.yaml

Lines 1 to 24 in dcc1f4a

	---
	title: OneTimeKeys
	type: object
	description: |-
	One-time public keys. The names of the properties should be in the format
	`<algorithm>:<key_id>`. The format of the key is determined
	by the [key algorithm](/client-server-api/#key-algorithms).
	additionalProperties:
	oneOf:
	- type: string
	- type: object
	properties:
	key:
	type: string
	description: The key, encoded using unpadded base64.
	signatures:
	type: object
	description: |-
	Signature for the device. Mapped from user ID to signature object,
	containing mapping from _key signing identifier_ to the signature
	(see also: https://spec.matrix.org/v1.2/appendices/#signing-json)
	additionalProperties:
	type: object
	required: ['key', 'signatures']

[DMRobertson]

Possibly related: #1162

[DMRobertson]

#1127 suggests that this can't be done unless we upgrade to OpenAPI v3.

[KitsuneRal]

Exactly; that's the only reason it's not defined. Actually, I even left the definition in its own file, it's just not ref'ed from the API definition.

[richvdh]

We now have OpenAPI v3, and this could be looked at again