[HTTP/OAS] Add tags and summaries for saved object APIs (#184184)

Co-authored-by: Jean-Louis Leysens <jloleysens@gmail.com>

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/bulk_create.ts

@@ -34,8 +34,9 @@ export const registerBulkCreateRoute = (
     {
       path: '/_bulk_create',
       options: {
+        summary: `Create saved objects`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Create saved objects`,
       },
       validate: {
         query: schema.object({

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/bulk_delete.ts

@@ -34,8 +34,9 @@ export const registerBulkDeleteRoute = (
     {
       path: '/_bulk_delete',
       options: {
+        summary: `Delete saved objects`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Remove saved objects`,
       },
       validate: {
         body: schema.arrayOf(

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/bulk_get.ts

@@ -34,8 +34,9 @@ export const registerBulkGetRoute = (
     {
       path: '/_bulk_get',
       options: {
+        summary: `Get saved objects`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Get saved objects`,
       },
       validate: {
         body: schema.arrayOf(

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/bulk_resolve.ts

@@ -34,8 +34,9 @@ export const registerBulkResolveRoute = (
     {
       path: '/_bulk_resolve',
       options: {
+        summary: `Resolve saved objects`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Resolve saved objects`,
       },
       validate: {
         body: schema.arrayOf(

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/bulk_update.ts

@@ -34,8 +34,9 @@ export const registerBulkUpdateRoute = (
     {
       path: '/_bulk_update',
       options: {
+        summary: `Update saved objects`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Update saved objects`,
       },
       validate: {
         body: schema.arrayOf(

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/create.ts

@@ -34,8 +34,9 @@ export const registerCreateRoute = (
     {
       path: '/{type}/{id?}',
       options: {
+        summary: `Create a saved object`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Create a saved object`,
       },
       validate: {
         params: schema.object({

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/delete.ts

@@ -34,8 +34,9 @@ export const registerDeleteRoute = (
     {
       path: '/{type}/{id}',
       options: {
+        summary: `Delete a saved object`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Delete a saved object`,
       },
       validate: {
         params: schema.object({

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/export.ts

@@ -144,8 +144,9 @@ export const registerExportRoute = (
     {
       path: '/_export',
       options: {
+        summary: `Export saved objects`,
+        tags: ['oas-tag:saved objects'],
         access: 'public',
-        description: `Export saved objects`,
       },
       validate: {
         body: schema.object({

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/find.ts

@@ -38,8 +38,9 @@ export const registerFindRoute = (
     {
       path: '/_find',
       options: {
+        summary: `Search for saved objects`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Search for saved objects`,
       },
       validate: {
         query: schema.object({

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/get.ts

@@ -34,8 +34,9 @@ export const registerGetRoute = (
     {
       path: '/{type}/{id}',
       options: {
+        summary: `Get a saved object`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Get a saved object`,
       },
       validate: {
         params: schema.object({

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/import.ts

@@ -36,8 +36,9 @@ export const registerImportRoute = (
     {
       path: '/_import',
       options: {
+        summary: `Import saved objects`,
+        tags: ['oas-tag:saved objects'],
         access: 'public',
-        description: `Import saved objects`,
         body: {
           maxBytes: maxImportPayloadBytes,
           output: 'stream',

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/resolve.ts

@@ -30,8 +30,9 @@ export const registerResolveRoute = (
     {
       path: '/resolve/{type}/{id}',
       options: {
+        summary: `Resolve a saved object`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Resolve a saved object`,
       },
       validate: {
         params: schema.object({

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/resolve_import_errors.ts

@@ -37,8 +37,9 @@ export const registerResolveImportErrorsRoute = (
     {
       path: '/_resolve_import_errors',
       options: {
+        summary: `Resolve import errors`,
+        tags: ['oas-tag:saved objects'],
         access: 'public',
-        description: `Resolve import errors`,
         body: {
           maxBytes: maxImportPayloadBytes,
           output: 'stream',

packages/core/saved-objects/core-saved-objects-server-internal/src/routes/update.ts

@@ -35,8 +35,9 @@ export const registerUpdateRoute = (
     {
       path: '/{type}/{id}',
       options: {
+        summary: `Update a saved object`,
+        tags: ['oas-tag:saved objects'],
         access,
-        description: `Update a saved object`,
       },
       validate: {
         params: schema.object({

x-pack/plugins/encrypted_saved_objects/server/routes/key_rotation.test.ts

@@ -43,7 +43,10 @@ describe('Key rotation routes', () => {
     });
 
     it('correctly defines route.', () => {
-      expect(routeConfig.options).toEqual({ tags: ['access:rotateEncryptionKey'] });
+      expect(routeConfig.options).toEqual({
+        tags: ['access:rotateEncryptionKey', 'oas-tag:saved objects'],
+        description: `Rotate a key for encrypted saved objects`,
+      });
       expect(routeConfig.validate).toEqual({
         body: undefined,
         query: expect.any(Type),

x-pack/plugins/encrypted_saved_objects/server/routes/key_rotation.ts

@@ -39,7 +39,8 @@ export function defineKeyRotationRoutes({
         }),
       },
       options: {
-        tags: ['access:rotateEncryptionKey'],
+        tags: ['access:rotateEncryptionKey', 'oas-tag:saved objects'],
+        description: `Rotate a key for encrypted saved objects`,
       },
     },
     async (context, request, response) => {