Improve doc

src/server/api/endpoints/messaging/history.ts

@@ -20,7 +20,14 @@ export const meta = {
 			validator: $.optional.num.range(1, 100),
 			default: 10
 		}
-	}
+	},
+
+	res: {
+		type: 'array',
+		items: {
+			type: 'MessagingMessage',
+		},
+	},
 };
 
 export default define(meta, async (ps, user) => {

src/server/api/endpoints/messaging/messages.ts

@@ -50,6 +50,13 @@ export const meta = {
 		}
 	},
 
+	res: {
+		type: 'array',
+		items: {
+			type: 'MessagingMessage',
+		},
+	},
+
 	errors: {
 		noSuchUser: {
 			message: 'No such user.',

src/server/api/endpoints/messaging/messages/create.ts

@@ -45,6 +45,10 @@ export const meta = {
 		}
 	},
 
+	res: {
+		type: 'MessagingMessage',
+	},
+
 	errors: {
 		recipientIsYourself: {
 			message: 'You can not send a message to yourself.',

src/server/api/openapi/schemas.ts

@@ -119,6 +119,39 @@ export const schemas = {
 		required: ['id', 'createdAt', 'title']
 	},
 
+	MessagingMessage: {
+		type: 'object',
+		properties: {
+			id: {
+				type: 'string',
+				format: 'id',
+				description: 'The unique identifier for this MessagingMessage.',
+				example: 'xxxxxxxxxxxxxxxxxxxxxxxx',
+			},
+			createdAt: {
+				type: 'string',
+				format: 'date-time',
+				description: 'The date that the MessagingMessage was created.'
+			},
+			text: {
+				type: 'string',
+				nullable: true
+			},
+			file: {
+				type: 'DriveFile',
+				nullable: true
+			},
+			recipientId: {
+				type: 'string',
+				format: 'id',
+			},
+			recipient: {
+				$ref: '#/components/schemas/User'
+			},
+		},
+		required: ['id', 'createdAt']
+	},
+
 	Note: {
 		type: 'object',
 		properties: {