{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Update an existing data connector. Only provided fields are changed. Set `state` to `live` or `draft` to change the connector's state.\n\nOAuth tokens must have the `read_write_data_connectors` scope.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"path":{"type":"object","properties":{"id":{"type":"string","examples":["12345"],"description":"The unique identifier of the data connector."}},"required":["id"],"additionalProperties":false},"body":{"$ref":"#/definitions/update_data_connector_request","examples":[{"name":"Updated Connector Name","description":"Updated description"}]}},"required":["path"],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]},"update_data_connector_request":{"title":"Update Data Connector Request","type":"object","description":"Update an existing data connector. All fields are optional — only provided fields will be updated. Set `state` to `live` or `draft` to change the connector's state.\n","properties":{"name":{"type":"string","description":"The name of the data connector.","examples":["Updated Connector Name"]},"description":{"type":"string","description":"A description of what this data connector does.","examples":["Updated description"]},"internal_description":{"type":"string","description":"The internal description of the data connector. If omitted, it keeps its current value, unless the connector has no internal description yet, in which case it is set to the connector's `description`."},"state":{"type":"string","description":"The desired state of the connector.","enum":["draft","live"]},"http_method":{"type":"string","description":"The HTTP method used by the data connector.","enum":["get","post","put","delete","patch"],"examples":["post"]},"url":{"type":"string","description":"The URL of the external API endpoint. Supports template variables like `{{order_id}}`.","examples":["https://api.example.com/orders/{{order_id}}/status"]},"body":{"type":"string","description":"The request body template. Supports template variables."},"direct_fin_usage":{"type":"boolean","description":"Whether this connector is used directly by Fin.","examples":[false]},"audiences":{"type":"array","description":"The audience types this connector targets.","items":{"type":"string","enum":["leads","users","visitors"]},"examples":[["leads","users"]]},"headers":{"type":"array","description":"HTTP headers to include in the request. Don't put credentials such as API keys here: header values are recorded unmasked in the connector's execution logs, except `Authorization`, which is always masked. Attach an authentication token with `token_ids` instead; its value is masked in execution logs.\n","items":{"type":"object","properties":{"name":{"type":"string","description":"The header name.","examples":["Content-Type"]},"value":{"type":"string","description":"The header value. Supports template variables.","examples":["application/json"]}},"required":["name","value"]}},"data_inputs":{"type":"array","description":"The input parameters accepted by this data connector. Replaces all existing inputs.","items":{"type":"object","properties":{"name":{"type":"string","description":"The name of the input parameter.","examples":["order_id"]},"type":{"type":"string","description":"The data type of the input.","enum":["string","integer","decimal","boolean"],"examples":["string"]},"description":{"type":"string","description":"A description of the input parameter. Required for each input.","examples":["The order ID to look up"]},"required":{"type":"boolean","description":"Whether this input is required.","examples":[true]},"default_value":{"type":"string","description":"The default value for this input, if any."}},"required":["name","description","type","required"]}},"customer_authentication":{"type":"boolean","description":"Whether OTP authentication is enabled for this connector.","examples":[false]},"bypass_authentication":{"type":"boolean","description":"Whether authentication is bypassed for this connector.","examples":[false]},"enforce_auth":{"type":"boolean","description":"Whether authentication is enforced. On workspaces where this is supported, it takes precedence over `customer_authentication` and `bypass_authentication` when sent together, and setting it to false disables OTP."},"validate_missing_attributes":{"type":"boolean","description":"Whether to validate missing attributes before execution.","examples":[true]},"mock_response":{"type":"object","description":"A sample JSON response from the external API. Auto-generates `response_fields` and sets `configuration_response_type` to `mock_response_type`.","examples":[{"order":{"id":12345,"status":"shipped"}}]},"token_ids":{"type":"array","description":"IDs of authentication tokens to attach to this data connector. An empty array removes all tokens.","items":{"type":"string"},"examples":[["1234","5678"]]}}}}},"name":"Update a data connector","id":"intercom.updatedataconnector","example":{"path":{"id":"12345"}},"maxRequests":1,"summary":false}}