[ResponseOps][Rules] Add deprecation object to deprecated endpoints

[jcger]

We need to replace deprecated: true with the deprecated object in

Copied from #196095:
Here is an example of what true needs to be replaced with (note the options.deprecated param):

  router.versioned
    .get({
      path: '/',
      access: 'public',
      enableQueryVersion: true,
    })
    .addVersion(
      {
        validate: false,
        version: '2023-10-31',
        options: {
          deprecated: {
            documentationUrl: 'https://google.com',
            severity: 'warning',
            reason: {
              type: 'bump',
              newApiVersion: '2024-10-13',
            },
          },
        },
      },

the list of deprecated endpoints can be found here #195179.

Example PR: #198527.

[elasticmachine]

Pinging @elastic/response-ops (Team:ResponseOps)

[lcawl]

I presume in addition to the changes in xxx, this means we can update the OpenAPI document (e.g. to remove
api/cases/status from https://github.com/elastic/kibana/blob/main/x-pack/plugins/cases/docs/openapi/entrypoint.yaml so it's no longer published here https://www.elastic.co/docs/api/doc/kibana/operation/operation-getcasestatusdefaultspace)?

[jcger]

I presume in addition to the changes in xxx, this means we can update the OpenAPI document (e.g. to remove api/cases/status from https://github.com/elastic/kibana/blob/main/x-pack/plugins/cases/docs/openapi/entrypoint.yaml so it's no longer published here https://www.elastic.co/docs/api/doc/kibana/operation/operation-getcasestatusdefaultspace)?

AFAIK as long as it's only for v9 yes. I would include removing the docs entry as part of the issue to remove the endpoints so we do everything at once