Add specification for update connector features (#3364) (#3379)

(cherry picked from commit 3937036)

Co-authored-by: Lisa Cawley <[email protected]>

specification/_doc_ids/table.csv

@@ -96,6 +96,7 @@ connector-sync-job-post,https://www.elastic.co/guide/en/elasticsearch/reference/
 connector-sync-job-list,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/list-connector-sync-jobs-api.html
 connector-checkin,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/check-in-connector-api.html
 connector-delete,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/delete-connector-api.html
+connector-features,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-features-api.html
 connector-get,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-connector-api.html
 connector-last-sync,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-last-sync-api.html
 connector-list,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/list-connector-api.html

specification/connector/_types/Connector.ts

@@ -217,13 +217,28 @@ interface FeatureEnabled {
 }
 
 interface SyncRulesFeature {
+  /**
+   * Indicates whether advanced sync rules are enabled.
+   */
   advanced?: FeatureEnabled
+  /**
+   * Indicates whether basic sync rules are enabled.
+   */
   basic?: FeatureEnabled
 }
 
 export interface ConnectorFeatures {
+  /**
+   * Indicates whether document-level security is enabled.
+   */
   document_level_security?: FeatureEnabled
+  /**
+   * Indicates whether incremental syncs are enabled.
+   */
   incremental_sync?: FeatureEnabled
+  /**
+   *  Indicates whether managed connector API keys are enabled.
+   */
   native_connector_api_keys?: FeatureEnabled
   sync_rules?: SyncRulesFeature
 }

specification/connector/update_features/ConnectorUpdateFeaturesRequest.ts

@@ -0,0 +1,55 @@
+/*
+ * Licensed to Elasticsearch B.V. under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch B.V. licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { RequestBase } from '@_types/Base'
+import { Id } from '@_types/common'
+import { ConnectorFeatures } from '../_types/Connector'
+
+/**
+ * Update the connector features.
+ * Update the connector features in the connector document.
+ * This API can be used to control the following aspects of a connector:
+ *
+ * * document-level security
+ * * incremental syncs
+ * * advanced sync rules
+ * * basic sync rules
+ *
+ * Normally, the running connector service automatically manages these features.
+ * However, you can use this API to override the default behavior.
+ *
+ * To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure.
+ * This service runs automatically on Elastic Cloud for Elastic managed connectors.
+ * @rest_spec_name connector.update_features
+ * @availability stack stability=experimental visibility=public
+ * @doc_id connector-features
+ */
+export interface Request extends RequestBase {
+  path_parts: {
+    /**
+     * The unique identifier of the connector to be updated.
+     */
+    connector_id: Id
+  }
+  /**
+   * The connector configuration
+   */
+  body: {
+    features: ConnectorFeatures
+  }
+}