Improve doc

src/server/api/endpoints/users/lists/list.ts

@@ -10,7 +10,14 @@ export const meta = {
 
 	requireCredential: true,
 
-	kind: 'account-read'
+	kind: 'account-read',
+
+	res: {
+		type: 'array',
+		items: {
+			type: 'UserList',
+		},
+	},
 };
 
 export default define(meta, async (ps, me) => {

src/server/api/endpoints/users/lists/show.ts

@@ -23,6 +23,10 @@ export const meta = {
 		},
 	},
 
+	res: {
+		type: 'UserList'
+	},
+
 	errors: {
 		noSuchList: {
 			message: 'No such list.',

src/server/api/openapi/schemas.ts

@@ -97,6 +97,28 @@ export const schemas = {
 		required: ['id', 'name', 'username', 'createdAt']
 	},
 
+	UserList: {
+		type: 'object',
+		properties: {
+			id: {
+				type: 'string',
+				format: 'id',
+				description: 'The unique identifier for this UserList.',
+				example: 'xxxxxxxxxxxxxxxxxxxxxxxx',
+			},
+			createdAt: {
+				type: 'string',
+				format: 'date-time',
+				description: 'The date that the UserList was created.'
+			},
+			title: {
+				type: 'string',
+				description: 'The name of the UserList.'
+			},
+		},
+		required: ['id', 'createdAt', 'title']
+	},
+
 	Note: {
 		type: 'object',
 		properties: {