diff --git a/docs/api-generated/README.md b/docs/api-generated/README.md index fd76a53a9fae2..6eda1a4d2e9f1 100644 --- a/docs/api-generated/README.md +++ b/docs/api-generated/README.md @@ -14,15 +14,18 @@ or a similar tool that can generate HTML output from OAS. . Generate HTML output. For example: ``` - openapi-generator-cli generate -g html -i ~/kibana/x-pack/plugins/cases/docs/openapi/bundled.yaml -o ~/kibana/docs/api-generated/cases -t ~/kibana/docs/api-generated/template + openapi-generator-cli generate -g html -i $GIT_HOME/kibana/x-pack/plugins/cases/docs/openapi/bundled.yaml -o $GIT_HOME/kibana/docs/api-generated/cases -t $GIT_HOME/kibana/docs/api-generated/template - openapi-generator-cli generate -g html -i ~/kibana/x-pack/plugins/ml/common/openapi/ml_apis_v3.yaml -o ~/kibana/docs/api-generated/machine-learning -t ~/kibana/docs/api-generated/template + openapi-generator-cli generate -g html -i $GIT_HOME/kibana/x-pack/plugins/actions/docs/openapi/bundled.yaml -o $GIT_HOME/kibana/docs/api-generated/connectors -t $GIT_HOME/kibana/docs/api-generated/template + + openapi-generator-cli generate -g html -i $GIT_HOME/kibana/x-pack/plugins/ml/common/openapi/ml_apis_v3.yaml -o $GIT_HOME/kibana/docs/api-generated/machine-learning -t $GIT_HOME/kibana/docs/api-generated/template ``` . Rename the output files. For example: ``` - mv ~/kibana/docs/api-generated/cases/index.html case-apis-passthru.asciidoc - mv ~/kibana/docs/api-generated/machine-learning/index.html ml-apis-passthru.adoc + mv $GIT_HOME/kibana/docs/api-generated/cases/index.html $GIT_HOME/kibana/docs/api-generated/cases/case-apis-passthru.asciidoc + mv $GIT_HOME/kibana/docs/api-generated/connectors/index.html $GIT_HOME/kibana/docs/api-generated/connectors/connector-apis-passthru.asciidoc + mv $GIT_HOME/kibana/docs/api-generated/machine-learning/index.html $GIT_HOME/kibana/docs/api-generated/machine-learning/ml-apis-passthru.adoc ``` . If you're creating a new set of API output, you will need to have a page that incorporates the output by using passthrough blocks. For more information, refer to [Asciidoctor docs](https://docs.asciidoctor.org/asciidoc/latest/pass/pass-block/) diff --git a/docs/api-generated/connectors/connector-apis-passthru.asciidoc b/docs/api-generated/connectors/connector-apis-passthru.asciidoc new file mode 100644 index 0000000000000..fd97cd89608b9 --- /dev/null +++ b/docs/api-generated/connectors/connector-apis-passthru.asciidoc @@ -0,0 +1,113 @@ +//// +This content is generated from the open API specification. +Any modifications made to this file will be overwritten. +//// + +++++ +
+

Access

+
    +
  1. APIKey KeyParamName:ApiKey KeyInQuery:false KeyInHeader:true
  2. +
  3. HTTP Basic Authentication
  4. +
+ +

Methods

+ [ Jump to Models ] + +

Table of Contents

+
+

Cases

+ + +

Cases

+
+
+ Up +
get /s/{spaceId}/api/actions/connector_types
+
Retrieves a list of all connector types. (getConnectorTypes)
+
You do not need any Kibana feature privileges to run this API.
+ +

Path parameters

+
+
spaceId (required)
+ +
Path Parameter — An identifier for the space. If /s/ and the identifier are omitted from the path, the default space is used. default: null
+
+ + + + +

Query parameters

+
+
feature_id (optional)
+ +
Query Parameter — A filter to limit the retrieved connector types to those that support a specific feature (such as alerting or cases). default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "supported_feature_ids" : [ "alerting", "uptime", "siem" ],
+  "name" : "Index",
+  "enabled_in_license" : true,
+  "id" : ".index",
+  "enabled_in_config" : true,
+  "minimum_license_required" : "basic",
+  "enabled" : true
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ Indicates a successful call. + +
+
+ +

Models

+ [ Jump to Methods ] + +

Table of Contents

+
    +
  1. features -
  2. +
  3. getConnectorTypes_200_response_inner -
  4. +
+ +
+

features - Up

+
The feature that uses the connector. Valid values are alerting, cases, uptime, and siem.
+
+
+
+
+

getConnectorTypes_200_response_inner - Up

+
+
+
enabled (optional)
Boolean Indicates whether the connector type is enabled in Kibana.
+
enabled_in_config (optional)
Boolean Indicates whether the connector type is enabled in the Kibana .yml file.
+
enabled_in_license (optional)
Boolean Indicates whether the connector is enabled in the license.
+
id (optional)
String The unique identifier for the connector type.
+
minimum_license_required (optional)
String The license that is required to use the connector type.
+
name (optional)
String The name of the connector type.
+
supported_feature_ids (optional)
array[features] The Kibana features that are supported by the connector type.
+
+
+
+++++ diff --git a/docs/api-generated/connectors/connector-apis.asciidoc b/docs/api-generated/connectors/connector-apis.asciidoc new file mode 100644 index 0000000000000..d35bad3d3d633 --- /dev/null +++ b/docs/api-generated/connectors/connector-apis.asciidoc @@ -0,0 +1,10 @@ +[[connector-apis]] +== Connector APIs + +preview::[] + +//// +This file includes content that has been generated from https://github.com/elastic/kibana/tree/main/x-pack/plugins/actions/docs/openapi. Any modifications required must be done in that open API specification. +//// + +include::connector-apis-passthru.asciidoc[] \ No newline at end of file diff --git a/docs/api/actions-and-connectors.asciidoc b/docs/api/actions-and-connectors.asciidoc index 1e8b5d426e310..68e89c5eecaf6 100644 --- a/docs/api/actions-and-connectors.asciidoc +++ b/docs/api/actions-and-connectors.asciidoc @@ -26,7 +26,7 @@ include::actions-and-connectors/create.asciidoc[leveloffset=+1] include::actions-and-connectors/delete.asciidoc[leveloffset=+1] include::actions-and-connectors/get.asciidoc[leveloffset=+1] include::actions-and-connectors/get_all.asciidoc[leveloffset=+1] -include::actions-and-connectors/list.asciidoc[] +include::actions-and-connectors/list.asciidoc[leveloffset=+1] include::actions-and-connectors/execute.asciidoc[leveloffset=+1] include::actions-and-connectors/update.asciidoc[leveloffset=+1] include::actions-and-connectors/legacy/index.asciidoc[] diff --git a/docs/api/actions-and-connectors/list.asciidoc b/docs/api/actions-and-connectors/list.asciidoc index e5ddc4f0f134c..d7658cdd11da4 100644 --- a/docs/api/actions-and-connectors/list.asciidoc +++ b/docs/api/actions-and-connectors/list.asciidoc @@ -1,13 +1,19 @@ [[list-connector-types-api]] -=== List connector types API +== List connector types API ++++ List all connector types ++++ Retrieves a list of all connector types. +[NOTE] +==== +For the most up-to-date API details, refer to the +{kib-repo}/tree/{branch}/x-pack/plugins/actions/docs/openapi[open API specification]. For a preview, check out <>. +==== + [[list-connector-types-api-request]] -==== {api-request-title} +=== {api-request-title} `GET :/api/actions/connector_types` @@ -21,7 +27,7 @@ You do not need any <> to run this API. [[list-connector-types-api-path-params]] -==== {api-path-parms-title} +=== {api-path-parms-title} `space_id`:: (Optional, string) An identifier for the space. If `space_id` is not provided in the URL, the default space is used. @@ -33,13 +39,13 @@ run this API. (Optional, string) Filters list of connector types to those that support the feature id. [[list-connector-types-api-codes]] -==== {api-response-codes-title} +=== {api-response-codes-title} `200`:: Indicates a successful call. [[list-connector-types-api-example]] -==== {api-examples-title} +=== {api-examples-title} [source,sh] -------------------------------------------------- diff --git a/docs/apis.asciidoc b/docs/apis.asciidoc index 8b07e58d4f8aa..197022e16f588 100644 --- a/docs/apis.asciidoc +++ b/docs/apis.asciidoc @@ -12,4 +12,5 @@ version of the specification is 3.0. For more information, go to https://openapi -- include::api-generated/cases/case-apis.asciidoc[] +include::api-generated/connectors/connector-apis.asciidoc[] include::api-generated/machine-learning/ml-apis.asciidoc[] \ No newline at end of file diff --git a/x-pack/plugins/actions/docs/openapi/README.md b/x-pack/plugins/actions/docs/openapi/README.md new file mode 100644 index 0000000000000..cb0ebce144876 --- /dev/null +++ b/x-pack/plugins/actions/docs/openapi/README.md @@ -0,0 +1,34 @@ +# OpenAPI (Experimental) + +The current self-contained spec file is [as JSON](https://raw.githubusercontent.com/elastic/kibana/master/x-pack/plugins/cases/common/openapi/bundled.json) or [as YAML](https://raw.githubusercontent.com/elastic/kibana/master/x-pack/plugins/cases/common/openapi/bundled.yaml) and can be used for online tools like those found at https://openapi.tools/. +This spec is experimental and may be incomplete or change later. + +A guide about the openApi specification can be found at [https://swagger.io/docs/specification/about/](https://swagger.io/docs/specification/about/). + +## The `openapi` folder + +* `entrypoint.yaml` is the overview file which pulls together all the paths and components. +* [Paths](paths/README.md): this defines each endpoint. A path can have one operation per http method. +* [Components](components/README.md): Reusable components + +## Tools + +It is possible to validate the docs before bundling them with the following +command in the `x-pack/plugins/actions/docs/openapi/` folder: + + ``` + npx swagger-cli validate entrypoint.yaml + ``` + +Then you can generate the `bundled` files by running the following commands: + + ``` + npx @redocly/cli bundle entrypoint.yaml --output bundled.yaml --ext yaml + npx @redocly/cli bundle entrypoint.yaml --output bundled.json --ext json + ``` + +You can run additional linting with the following command: + + ``` + npx @redocly/cli lint bundled.json + ``` diff --git a/x-pack/plugins/actions/docs/openapi/bundled.json b/x-pack/plugins/actions/docs/openapi/bundled.json new file mode 100644 index 0000000000000..59e4a0ba85ce9 --- /dev/null +++ b/x-pack/plugins/actions/docs/openapi/bundled.json @@ -0,0 +1,216 @@ +{ + "openapi": "3.0.1", + "info": { + "title": "Connectors", + "description": "OpenAPI schema for Connectors endpoints", + "version": "0.1", + "contact": { + "name": "Connectors Team" + }, + "license": { + "name": "Elastic License 2.0", + "url": "https://www.elastic.co/licensing/elastic-license" + } + }, + "tags": [ + { + "name": "connectors", + "description": "Connector APIs enable you to create and manage connectors." + } + ], + "servers": [ + { + "url": "http://localhost:5601", + "description": "local" + } + ], + "paths": { + "/s/{spaceId}/api/actions/connector_types": { + "get": { + "summary": "Retrieves a list of all connector types.", + "operationId": "getConnectorTypes", + "description": "You do not need any Kibana feature privileges to run this API.\n", + "tags": [ + "cases" + ], + "parameters": [ + { + "$ref": "#/components/parameters/space_id" + }, + { + "in": "query", + "name": "feature_id", + "description": "A filter to limit the retrieved connector types to those that support a specific feature (such as alerting or cases).", + "schema": { + "$ref": "#/components/schemas/features" + } + } + ], + "responses": { + "200": { + "description": "Indicates a successful call.", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "description": "Indicates whether the connector type is enabled in Kibana.", + "example": true + }, + "enabled_in_config": { + "type": "boolean", + "description": "Indicates whether the connector type is enabled in the Kibana `.yml` file.", + "example": true + }, + "enabled_in_license": { + "type": "boolean", + "description": "Indicates whether the connector is enabled in the license.", + "example": true + }, + "id": { + "type": "string", + "description": "The unique identifier for the connector type.", + "example": ".index" + }, + "minimum_license_required": { + "type": "string", + "description": "The license that is required to use the connector type.", + "example": "basic" + }, + "name": { + "type": "string", + "description": "The name of the connector type.", + "example": "Index" + }, + "supported_feature_ids": { + "type": "array", + "description": "The Kibana features that are supported by the connector type.", + "items": { + "$ref": "#/components/schemas/features" + }, + "example": [ + "alerting", + "uptime", + "siem" + ] + } + } + } + }, + "examples": { + "getConnectorTypesResponse": { + "$ref": "#/components/examples/get_connector_types_response" + } + } + } + } + } + }, + "servers": [ + { + "url": "https://localhost:5601" + } + ] + }, + "servers": [ + { + "url": "https://localhost:5601" + } + ] + } + }, + "components": { + "securitySchemes": { + "basicAuth": { + "type": "http", + "scheme": "basic" + }, + "apiKeyAuth": { + "type": "apiKey", + "in": "header", + "name": "ApiKey" + } + }, + "parameters": { + "space_id": { + "in": "path", + "name": "spaceId", + "description": "An identifier for the space. If `/s/` and the identifier are omitted from the path, the default space is used.", + "required": true, + "schema": { + "type": "string", + "example": "default" + } + } + }, + "schemas": { + "features": { + "type": "string", + "description": "The feature that uses the connector. Valid values are `alerting`, `cases`, `uptime`, and `siem`.\n", + "enum": [ + "alerting", + "cases", + "uptime", + "siem" + ] + } + }, + "examples": { + "get_connector_types_response": { + "summary": "A list of connector types", + "value": [ + { + "id": ".swimlane", + "name": "Swimlane", + "enabled": true, + "enabled_in_config": true, + "enabled_in_license": true, + "minimum_license_required": "gold", + "supported_feature_ids": [ + "alerting", + "cases", + "siem" + ] + }, + { + "id": ".index", + "name": "Index", + "enabled": true, + "enabled_in_config": true, + "enabled_in_license": true, + "minimum_license_required": "basic", + "supported_feature_ids": [ + "alerting", + "uptime", + "siem" + ] + }, + { + "id": ".server-log", + "name": "Server log", + "enabled": true, + "enabled_in_config": true, + "enabled_in_license": true, + "minimum_license_required": "basic", + "supported_feature_ids": [ + "alerting", + "uptime" + ] + } + ] + } + } + }, + "security": [ + { + "basicAuth": [] + }, + { + "apiKeyAuth": [] + } + ] +} \ No newline at end of file diff --git a/x-pack/plugins/actions/docs/openapi/bundled.yaml b/x-pack/plugins/actions/docs/openapi/bundled.yaml new file mode 100644 index 0000000000000..db2d1863854a9 --- /dev/null +++ b/x-pack/plugins/actions/docs/openapi/bundled.yaml @@ -0,0 +1,146 @@ +openapi: 3.0.1 +info: + title: Connectors + description: OpenAPI schema for Connectors endpoints + version: '0.1' + contact: + name: Connectors Team + license: + name: Elastic License 2.0 + url: https://www.elastic.co/licensing/elastic-license +tags: + - name: connectors + description: Connector APIs enable you to create and manage connectors. +servers: + - url: http://localhost:5601 + description: local +paths: + /s/{spaceId}/api/actions/connector_types: + get: + summary: Retrieves a list of all connector types. + operationId: getConnectorTypes + description: | + You do not need any Kibana feature privileges to run this API. + tags: + - cases + parameters: + - $ref: '#/components/parameters/space_id' + - in: query + name: feature_id + description: A filter to limit the retrieved connector types to those that support a specific feature (such as alerting or cases). + schema: + $ref: '#/components/schemas/features' + responses: + '200': + description: Indicates a successful call. + content: + application/json: + schema: + type: array + items: + type: object + properties: + enabled: + type: boolean + description: Indicates whether the connector type is enabled in Kibana. + example: true + enabled_in_config: + type: boolean + description: Indicates whether the connector type is enabled in the Kibana `.yml` file. + example: true + enabled_in_license: + type: boolean + description: Indicates whether the connector is enabled in the license. + example: true + id: + type: string + description: The unique identifier for the connector type. + example: .index + minimum_license_required: + type: string + description: The license that is required to use the connector type. + example: basic + name: + type: string + description: The name of the connector type. + example: Index + supported_feature_ids: + type: array + description: The Kibana features that are supported by the connector type. + items: + $ref: '#/components/schemas/features' + example: + - alerting + - uptime + - siem + examples: + getConnectorTypesResponse: + $ref: '#/components/examples/get_connector_types_response' + servers: + - url: https://localhost:5601 + servers: + - url: https://localhost:5601 +components: + securitySchemes: + basicAuth: + type: http + scheme: basic + apiKeyAuth: + type: apiKey + in: header + name: ApiKey + parameters: + space_id: + in: path + name: spaceId + description: An identifier for the space. If `/s/` and the identifier are omitted from the path, the default space is used. + required: true + schema: + type: string + example: default + schemas: + features: + type: string + description: | + The feature that uses the connector. Valid values are `alerting`, `cases`, `uptime`, and `siem`. + enum: + - alerting + - cases + - uptime + - siem + examples: + get_connector_types_response: + summary: A list of connector types + value: + - id: .swimlane + name: Swimlane + enabled: true + enabled_in_config: true + enabled_in_license: true + minimum_license_required: gold + supported_feature_ids: + - alerting + - cases + - siem + - id: .index + name: Index + enabled: true + enabled_in_config: true + enabled_in_license: true + minimum_license_required: basic + supported_feature_ids: + - alerting + - uptime + - siem + - id: .server-log + name: Server log + enabled: true + enabled_in_config: true + enabled_in_license: true + minimum_license_required: basic + supported_feature_ids: + - alerting + - uptime +security: + - basicAuth: [] + - apiKeyAuth: [] diff --git a/x-pack/plugins/actions/docs/openapi/components/examples/get_connector_types_response.yaml b/x-pack/plugins/actions/docs/openapi/components/examples/get_connector_types_response.yaml new file mode 100644 index 0000000000000..7566bddeb1a6d --- /dev/null +++ b/x-pack/plugins/actions/docs/openapi/components/examples/get_connector_types_response.yaml @@ -0,0 +1,31 @@ +summary: A list of connector types +value: + - id: .swimlane + name: Swimlane + enabled: true + enabled_in_config: true + enabled_in_license: true + minimum_license_required: gold + supported_feature_ids: + - alerting + - cases + - siem + - id: .index + name: Index + enabled: true + enabled_in_config: true + enabled_in_license: true + minimum_license_required: basic + supported_feature_ids: + - alerting + - uptime + - siem + - id: .server-log + name: Server log + enabled: true + enabled_in_config: true + enabled_in_license: true + minimum_license_required: basic + supported_feature_ids: + - alerting + - uptime diff --git a/x-pack/plugins/actions/docs/openapi/components/headers/kbn_xsrf.yaml b/x-pack/plugins/actions/docs/openapi/components/headers/kbn_xsrf.yaml new file mode 100644 index 0000000000000..3d8dfae634e68 --- /dev/null +++ b/x-pack/plugins/actions/docs/openapi/components/headers/kbn_xsrf.yaml @@ -0,0 +1,5 @@ +schema: + type: string +in: header +name: kbn-xsrf +required: true diff --git a/x-pack/plugins/actions/docs/openapi/components/parameters/space_id.yaml b/x-pack/plugins/actions/docs/openapi/components/parameters/space_id.yaml new file mode 100644 index 0000000000000..0a9fba457e3e7 --- /dev/null +++ b/x-pack/plugins/actions/docs/openapi/components/parameters/space_id.yaml @@ -0,0 +1,7 @@ +in: path +name: spaceId +description: An identifier for the space. If `/s/` and the identifier are omitted from the path, the default space is used. +required: true +schema: + type: string + example: default diff --git a/x-pack/plugins/actions/docs/openapi/components/schemas/features.yaml b/x-pack/plugins/actions/docs/openapi/components/schemas/features.yaml new file mode 100644 index 0000000000000..059e91cd79c7e --- /dev/null +++ b/x-pack/plugins/actions/docs/openapi/components/schemas/features.yaml @@ -0,0 +1,8 @@ +type: string +description: > + The feature that uses the connector. Valid values are `alerting`, `cases`, `uptime`, and `siem`. +enum: + - alerting + - cases + - uptime + - siem \ No newline at end of file diff --git a/x-pack/plugins/actions/docs/openapi/entrypoint.yaml b/x-pack/plugins/actions/docs/openapi/entrypoint.yaml new file mode 100644 index 0000000000000..fa5af148d6cd7 --- /dev/null +++ b/x-pack/plugins/actions/docs/openapi/entrypoint.yaml @@ -0,0 +1,51 @@ +openapi: 3.0.1 +info: + title: Connectors + description: OpenAPI schema for Connectors endpoints + version: '0.1' + contact: + name: Connectors Team + license: + name: Elastic License 2.0 + url: https://www.elastic.co/licensing/elastic-license +tags: + - name: connectors + description: Connector APIs enable you to create and manage connectors. +servers: + - url: 'http://localhost:5601' + description: local +paths: +# '/s/{spaceId}/api/actions/connector': +# $ref: 'paths/s@{spaceid}@api@actions@connector.yaml' +# '/s/{spaceId}/api/actions/connector/{connectorId}': +# $ref: 'paths/s@{spaceid}@api@actions@connector@{connectorid}.yaml' +# '/s/{spaceId}/api/actions/connectors': +# $ref: paths/s@{spaceid}@api@actions@connectors.yaml + '/s/{spaceId}/api/actions/connector_types': + $ref: paths/s@{spaceid}@api@actions@connector_types.yaml +# '/s/{spaceId}/api/actions/connector/{connectorId}/_execute': +# $ref: paths/s@{spaceid}@api@actions@connector@{connectorid}@_execute.yaml +# '/s/{spaceId}/api/actions/action/{actionId}': +# $ref: 'paths/s@{spaceid}@api@actions@action@{actionid}.yaml' +# '/s/{spaceId}/api/actions': +# $ref: 'paths/s@{spaceid}@api@actions.yaml' +# '/s/{spaceId}/api/actions/list_action_types': +# $ref: 'paths/s@{spaceid}@api@actions@list_action_types.yaml' +# '/s/{spaceId}/api/actions/action': +# $ref: 'paths/s@{spaceid}@api@actions@action.yaml' +# '/s/{spaceId}/api/actions/action/{actionId}': +# $ref: 'paths/s@{spaceid}@api@actions@action@{actionid}.yaml' +# '/s/{spaceId}/api/actions/action/{actionId}/_execute': +# $ref: 'paths/s@{spaceid}@api@actions@action@{actionid}@_execute.yaml' +components: + securitySchemes: + basicAuth: + type: http + scheme: basic + apiKeyAuth: + type: apiKey + in: header + name: ApiKey +security: + - basicAuth: [] + - apiKeyAuth: [] diff --git a/x-pack/plugins/actions/docs/openapi/paths/s@{spaceid}@api@actions@connector_types.yaml b/x-pack/plugins/actions/docs/openapi/paths/s@{spaceid}@api@actions@connector_types.yaml new file mode 100644 index 0000000000000..c5421c9abda54 --- /dev/null +++ b/x-pack/plugins/actions/docs/openapi/paths/s@{spaceid}@api@actions@connector_types.yaml @@ -0,0 +1,64 @@ +get: + summary: Retrieves a list of all connector types. + operationId: getConnectorTypes + description: > + You do not need any Kibana feature privileges to run this API. + tags: + - cases + parameters: + - $ref: '../components/parameters/space_id.yaml' + - in: query + name: feature_id + description: A filter to limit the retrieved connector types to those that support a specific feature (such as alerting or cases). + schema: + $ref: '../components/schemas/features.yaml' + responses: + '200': + description: Indicates a successful call. + content: + application/json: + schema: + type: array + items: + type: object + properties: + enabled: + type: boolean + description: Indicates whether the connector type is enabled in Kibana. + example: true + enabled_in_config: + type: boolean + description: Indicates whether the connector type is enabled in the Kibana `.yml` file. + example: true + enabled_in_license: + type: boolean + description: Indicates whether the connector is enabled in the license. + example: true + id: + type: string + description: The unique identifier for the connector type. + example: .index + minimum_license_required: + type: string + description: The license that is required to use the connector type. + example: basic + name: + type: string + description: The name of the connector type. + example: Index + supported_feature_ids: + type: array + description: The Kibana features that are supported by the connector type. + items: + $ref: '../components/schemas/features.yaml' + example: + - alerting + - uptime + - siem + examples: + getConnectorTypesResponse: + $ref: '../components/examples/get_connector_types_response.yaml' + servers: + - url: https://localhost:5601 +servers: + - url: https://localhost:5601