> This page is for API Reference & Tools.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Update HTTP connector

PATCH https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/{id}
Content-Type: application/json

Changes the fields you send and returns the full updated document.

Send only the fields you want to change, plus `version` with the `num` from your last read and a `change_description`. This is a JSON merge-patch: a field you leave out keeps its stored value, `null` clears it, and nested objects merge field by field. Lists of objects merge row by row instead of being replaced, so read the document first and send the whole list back when you reorder or remove rows. Lists of strings, Data Mapper expressions, JSON schemas, `workflow_steps` and `resolver_methods` are replaced whole. The `id` goes in the URL; if you also send `id` in the body it must match.

Reference: https://docs.moveworks.com/api-reference/configuration-api/tool-studio/http-connectors/update-http-connector

## Authentication

- `Authorization` header (bearer token, required) — JWT bearer token authentication. Include the Configuration API key in the Authorization header as 'Bearer \<token>'.

## Request

### Path parameters

- `id` (string, required) — The `id` of the HTTP connector, as returned when it was created or listed.

### Body (application/json)

This endpoint expects a HttpConnectorConfigPatch.

- `version` (HttpConnectorVersionPatch, required) — Document version. On update, send back the num from your last read.
- `base_url` (string, optional) — Base URL of the external API that every action path is appended to, for example https://api.example.com/v1. Must use https and a publicly reachable host unless the connector is routed through an on-premise agent.
- `basic_auth` (BasicAuthSettingsPatch, optional) — HTTP basic authentication with a username and password.
- `api_key_auth` (ApiKeyAuthSettingsPatch, optional) — API key authentication, sent in a header or query parameter.
- `oauth2` (OAuth2SettingsPatch, optional) — OAuth 2.0 authentication.
- `jwt_auth` (JwtAuthSettingsPatch, optional) — JWT bearer authentication signed with a private key you provide.
- `jwks_auth` (JwksAuthSettingsPatch, optional) — JWT bearer authentication signed with a key pair that Moveworks generates and rotates.
- `no_auth` (NoAuthSettings, optional) — No authentication. Set to an empty object to send requests without credentials.
- `headers` (list of RequestParameterSettingsPatch, optional) — Headers added to every request made through this connector.
- `query_params` (list of RequestParameterSettingsPatch, optional) — Query parameters added to every request made through this connector.
- `x509_options` (X509OptionsSettingsPatch, optional) — Client certificate and private key for mutual TLS. Used only when both are set.
- `csrf_token_options` (CsrfTokenOptionsSettings, optional) — Settings for fetching a CSRF token before requests, for systems that require one.

## Response

### 200

The updated HTTP connector, at its new version

- `id` (string, optional) — Unique identifier of the HTTP connector, assigned by the server.
- `name` (string, optional) — Unique name of the connector, used by HTTP actions to refer to it. 2-64 letters, digits or underscores, starting with a letter. Cannot be changed, or reused after deletion.
- `display_name` (string, optional) — Label shown for the connector in Tool Studio. Read-only; defaults to the name.
- `description` (string, optional) — Description of the connector as shown in Tool Studio. Read-only.
- `base_url` (string, optional) — Base URL of the external API that every action path is appended to, for example https://api.example.com/v1. Must use https and a publicly reachable host unless the connector is routed through an on-premise agent.
- `basic_auth` (BasicAuthSettings, optional) — HTTP basic authentication with a username and password.
- `api_key_auth` (ApiKeyAuthSettings, optional) — API key authentication, sent in a header or query parameter.
- `oauth2` (OAuth2Settings, optional) — OAuth 2.0 authentication.
- `jwt_auth` (JwtAuthSettings, optional) — JWT bearer authentication signed with a private key you provide.
- `jwks_auth` (JwksAuthSettings, optional) — JWT bearer authentication signed with a key pair that Moveworks generates and rotates.
- `no_auth` (NoAuthSettings, optional) — No authentication. Set to an empty object to send requests without credentials.
- `headers` (list of RequestParameterSettings, optional) — Headers added to every request made through this connector.
- `query_params` (list of RequestParameterSettings, optional) — Query parameters added to every request made through this connector.
- `x509_options` (X509OptionsSettings, optional) — Client certificate and private key for mutual TLS. Used only when both are set.
- `csrf_token_options` (CsrfTokenOptionsSettings, optional) — Settings for fetching a CSRF token before requests, for systems that require one.
- `updated_time` (datetime, optional) — When the configuration was last updated.
- `updated_by` (string, optional) — Who last updated the configuration.
- `version` (Version, optional) — Document version. On update, send back the num from your last read.

## Errors

### 400 Bad Request Error

Bad request - the body breaks a rule in the schema (a missing required field, an unknown enum value, an invalid DSL or Data Mapper expression), `version.change_description` is missing, or an id in the body doesn't match the URL

- `error` (ErrorResponseError, required)

### 401 Unauthorized Error

Unauthorized - the `Authorization` header is missing or the token is invalid

- `error` (ErrorResponseError, required)

### 403 Forbidden Error

Forbidden - the API key isn't allowed to change this configuration, or the configuration is frozen for your organization

- `error` (ErrorResponseError, required)

### 404 Not Found Error

Not found - no item with this `id` exists in your organization

- `error` (ErrorResponseError, required)

### 409 Conflict Error

Conflict - `version.num` doesn't match the stored version (someone changed it since your last read; read it again and retry), or the item already exists

- `error` (ErrorResponseError, required)

### 429 Too Many Requests Error

Too many requests - the organization exceeded the Configuration API rate limit. Back off and retry.

- `error` (ErrorResponseError, required)

### 500 Internal Server Error

Internal server error - retry the request

- `error` (ErrorResponseError, required)

## Types

### HttpConnectorVersionPatch

- `num` (integer, required) — Version number set by the server. On update, send the num from your last read; a stale num is rejected as a conflict.
- `change_description` (string, required) — A short note describing this change. Required on every create and update.

### BasicAuthSettingsPatch

- `username` (string, optional) — Username for HTTP basic authentication.
- `password` (string, optional) — Password for HTTP basic authentication. Secret: omit it, or send *****, to keep the stored value.

### ApiKeyAuthSettingsPatch

- `api_key` (string, optional) — API key issued by the external system. Secret: omit it, or send *****, to keep the stored value.
- `query_param` (ApiKeyQueryParamSettings, optional) — Send the key as a query parameter.
- `header` (AuthHeaderSettings, optional) — Send the key in a request header. Defaults to the Authorization header with the value Bearer followed by the key.

### OAuth2SettingsPatch

- `token_url` (string, optional) — Token endpoint URL of the authorization server. Optional for grants that do not exchange a token.
- `client_credentials_grant` (OAuth2ClientCredentialsGrantSettingsPatch, optional) — OAuth 2.0 client credentials grant.
- `password_grant` (OAuth2PasswordGrantSettingsPatch, optional) — OAuth 2.0 resource owner password grant.
- `refresh_token_grant` (OAuth2RefreshTokenGrantSettingsPatch, optional) — OAuth 2.0 refresh token grant, using a refresh token you provide.
- `jwt_grant` (JwtAuthSettingsPatch, optional) — JWT bearer assertion grant, signed with a private key you provide.
- `authorization_code_grant` (OAuth2AuthorizationCodeGrantSettingsPatch, optional) — OAuth 2.0 authorization code grant, where each user signs in to the external system and grants access.
- `saml_bearer_grant` (OAuth2SamlBearerGrantSettingsPatch, optional) — SAML 2.0 bearer assertion grant, using an assertion that Moveworks issues and signs.
- `jwks_grant` (JwksAuthSettingsPatch, optional) — JWT bearer assertion grant, signed with a key pair that Moveworks generates and rotates.
- `response_options` (OAuth2ResponseOptionsSettings, optional) — How to read the token response when it is not the standard JSON object with access_token and expires_in.
- `auth_header` (AuthHeaderSettings, optional) — How the access token is added to requests. Defaults to the Authorization header with the token as its value.
- `request_options` (OAuth2RequestOptionsSettingsPatch, optional) — Extra data to send on the token request beyond the standard grant fields.

### JwtAuthSettingsPatch

- `private_key` (string, optional) — PEM private key used to sign the JWT. Secret: omit it, or send *****, to keep the stored value.
- `key_id` (string, optional) — Key ID (kid header) that identifies the private key. Secret: omit it, or send *****, to keep the stored value.
- `algorithm` (enum, optional) — Signing algorithm. One of: ES256, RS256, HS256.
  - Allowed values: `ES256`, `RS256`, `HS256`
- `claims` (JwtClaimsSettings, optional) — Registered claims of the issued JWT.
- `headers` (list of JwtHeaderSettingsPatch, optional) — Additional JWT header parameters.
- `additional_claims` (list of JwtHeaderSettingsPatch, optional) — Claims to include beyond the registered claims.
- `assertion_key` (string, optional) — Name of the request field the signed JWT is sent under. Defaults to assertion.

### JwksAuthSettingsPatch

- `jwks` (string, optional) — Moveworks-generated key pair this connector signs with. Leave empty to generate a new key pair; send back the value from your last read to keep the current key. ID of an existing JwksSecret; not available through the Configuration API.
- `rotation_grace_period_hours` (JwksAuthSettingsPatchRotationGracePeriodHours, optional) — Hours the previous key stays valid after a rotation. 0 uses the default.
- `rotation_interval_days` (JwksAuthSettingsPatchRotationIntervalDays, optional) — Days between key rotations. 0 uses the default of 30 days.
- `claims` (JwtClaimsSettings, optional) — Registered claims of the issued JWT.
- `headers` (list of JwtHeaderSettingsPatch, optional) — Additional JWT header parameters.
- `additional_claims` (list of JwtHeaderSettingsPatch, optional) — Claims to include beyond the registered claims.
- `assertion_key` (string, optional) — Name of the request field the signed JWT is sent under. Defaults to assertion.

### NoAuthSettings

### RequestParameterSettingsPatch

- `key` (string, optional) — Header or query parameter name.
- `value` (string, optional) — Literal value.
- `credential` (TemplatedSecretSettingsPatch, optional) — Value built by inserting a secret into a pattern.

### X509OptionsSettingsPatch

- `certificate` (string, optional) — PEM client certificate. Secret: omit it, or send *****, to keep the stored value.
- `private_key` (string, optional) — PEM private key for the client certificate. Secret: omit it, or send *****, to keep the stored value.

### CsrfTokenOptionsSettings

- `endpoint_url` (string, optional) — Endpoint that issues the CSRF token, typically the service root. It is called with GET and the header x-csrf-token: Fetch, and the returned token is sent on later requests.

### BasicAuthSettings

- `username` (string, optional) — Username for HTTP basic authentication.
- `password` (string, optional) — Password for HTTP basic authentication. Secret: always returned masked as *****.

### ApiKeyAuthSettings

- `api_key` (string, optional) — API key issued by the external system. Secret: always returned masked as *****.
- `query_param` (ApiKeyQueryParamSettings, optional) — Send the key as a query parameter.
- `header` (AuthHeaderSettings, optional) — Send the key in a request header. Defaults to the Authorization header with the value Bearer followed by the key.

### OAuth2Settings

- `token_url` (string, optional) — Token endpoint URL of the authorization server. Optional for grants that do not exchange a token.
- `client_credentials_grant` (OAuth2ClientCredentialsGrantSettings, optional) — OAuth 2.0 client credentials grant.
- `password_grant` (OAuth2PasswordGrantSettings, optional) — OAuth 2.0 resource owner password grant.
- `refresh_token_grant` (OAuth2RefreshTokenGrantSettings, optional) — OAuth 2.0 refresh token grant, using a refresh token you provide.
- `jwt_grant` (JwtAuthSettings, optional) — JWT bearer assertion grant, signed with a private key you provide.
- `authorization_code_grant` (OAuth2AuthorizationCodeGrantSettings, optional) — OAuth 2.0 authorization code grant, where each user signs in to the external system and grants access.
- `saml_bearer_grant` (OAuth2SamlBearerGrantSettings, optional) — SAML 2.0 bearer assertion grant, using an assertion that Moveworks issues and signs.
- `jwks_grant` (JwksAuthSettings, optional) — JWT bearer assertion grant, signed with a key pair that Moveworks generates and rotates.
- `response_options` (OAuth2ResponseOptionsSettings, optional) — How to read the token response when it is not the standard JSON object with access_token and expires_in.
- `auth_header` (AuthHeaderSettings, optional) — How the access token is added to requests. Defaults to the Authorization header with the token as its value.
- `request_options` (OAuth2RequestOptionsSettings, optional) — Extra data to send on the token request beyond the standard grant fields.

### JwtAuthSettings

- `private_key` (string, optional) — PEM private key used to sign the JWT. Secret: always returned masked as *****.
- `key_id` (string, optional) — Key ID (kid header) that identifies the private key. Secret: always returned masked as *****.
- `algorithm` (enum, optional) — Signing algorithm. One of: ES256, RS256, HS256.
  - Allowed values: `ES256`, `RS256`, `HS256`
- `claims` (JwtClaimsSettings, optional) — Registered claims of the issued JWT.
- `headers` (list of JwtHeaderSettings, optional) — Additional JWT header parameters.
- `additional_claims` (list of JwtHeaderSettings, optional) — Claims to include beyond the registered claims.
- `assertion_key` (string, optional) — Name of the request field the signed JWT is sent under. Defaults to assertion.

### JwksAuthSettings

- `jwks` (string, optional) — Moveworks-generated key pair this connector signs with. Leave empty to generate a new key pair; send back the value from your last read to keep the current key. ID of an existing JwksSecret; not available through the Configuration API.
- `rotation_grace_period_hours` (JwksAuthSettingsRotationGracePeriodHours, optional) — Hours the previous key stays valid after a rotation. 0 uses the default.
- `rotation_interval_days` (JwksAuthSettingsRotationIntervalDays, optional) — Days between key rotations. 0 uses the default of 30 days.
- `claims` (JwtClaimsSettings, optional) — Registered claims of the issued JWT.
- `headers` (list of JwtHeaderSettings, optional) — Additional JWT header parameters.
- `additional_claims` (list of JwtHeaderSettings, optional) — Claims to include beyond the registered claims.
- `assertion_key` (string, optional) — Name of the request field the signed JWT is sent under. Defaults to assertion.

### RequestParameterSettings

- `key` (string, optional) — Header or query parameter name.
- `value` (string, optional) — Literal value.
- `credential` (TemplatedSecretSettings, optional) — Value built by inserting a secret into a pattern.

### X509OptionsSettings

- `certificate` (string, optional) — PEM client certificate. Secret: always returned masked as *****.
- `private_key` (string, optional) — PEM private key for the client certificate. Secret: always returned masked as *****.

### Version

- `num` (integer, optional) — Version number set by the server. On update, send the num from your last read; a stale num is rejected as a conflict.
- `change_description` (string, optional) — A short note describing this change. Required on every create and update.

### ErrorResponseError

- `code` (string, optional) — A machine-readable error code.
- `message` (string, optional) — What went wrong, and for a rejected field, which rule it broke.

### ApiKeyQueryParamSettings

- `name` (string, optional) — Name of the query parameter that carries the API key.

### AuthHeaderSettings

- `key` (string, optional) — Name of the header that carries the credential. Defaults to Authorization.
- `value_pattern` (string, optional) — Header value template, with %s replaced by the credential, for example Bearer %s. Defaults to %s for OAuth 2.0 tokens and Bearer %s for API keys.

### OAuth2ClientCredentialsGrantSettingsPatch

- `client_id` (string, optional) — Client ID issued by the authorization server.
- `client_secret` (string, optional) — Client secret issued by the authorization server. Secret: omit it, or send *****, to keep the stored value.
- `scope` (string, optional) — Scope to request from the authorization server.

### OAuth2PasswordGrantSettingsPatch

- `client_id` (string, optional) — Client ID issued by the authorization server.
- `client_secret` (string, optional) — Client secret issued by the authorization server. Secret: omit it, or send *****, to keep the stored value.
- `username` (string, optional) — Username of the account the token is requested for.
- `password` (string, optional) — Password of the account the token is requested for. Secret: omit it, or send *****, to keep the stored value.

### OAuth2RefreshTokenGrantSettingsPatch

- `client_id` (string, optional) — Client ID issued by the authorization server.
- `client_secret` (string, optional) — Client secret issued by the authorization server. Secret: omit it, or send *****, to keep the stored value.
- `refresh_token` (string, optional) — Refresh token used to obtain access tokens. Secret: omit it, or send *****, to keep the stored value.
- `scope` (string, optional) — Scope to request from the authorization server.

### OAuth2AuthorizationCodeGrantSettingsPatch

- `authorization_url` (string, optional) — Authorization endpoint URL of the authorization server, where users sign in and grant access.
- `client_id` (string, optional) — Client ID issued by the authorization server.
- `client_secret` (string, optional) — Client secret issued by the authorization server. Secret: omit it, or send *****, to keep the stored value.
- `scope` (string, optional) — Scope to request from the authorization server.
- `authorization_query_params` (list of AuthorizationQueryParamSettingsPatch, optional) — Additional query parameters added to the authorization request.
- `revoke_access_token_options` (OAuth2RevokeAccessTokenOptionsSettingsPatch, optional) — How to revoke a user's access token when they disconnect.
- `refresh_access_token_options` (OAuth2RefreshAccessTokenOptionsSettings, optional) — Options for refreshing access tokens.
- `pkce_algorithm` (string, optional) — PKCE code challenge method. One of: SHA256, PLAIN. Leave unset to disable PKCE. SHA256 is recommended; use PLAIN only if the server does not support S256.
- `on_premise_service_name` (string, optional) — Service name configured in the Moveworks on-premise agent, for connectors routed through that agent. Setting it also skips the public-host check on base_url.

### OAuth2SamlBearerGrantSettingsPatch

- `issuer` (string, optional) — SAML entity ID that Moveworks issues assertions as. Required for this grant.
- `client_id` (string, optional) — Client ID issued by the authorization server.
- `target_audience` (string, optional) — Entity ID of the target system, placed in the assertion's audience.
- `target_recipient` (string, optional) — URL that receives the assertion, typically the token endpoint.
- `signing_private_key` (string, optional) — PEM private key used to sign the assertions. Secret: omit it, or send *****, to keep the stored value.
- `signing_certificate` (string, optional) — X.509 certificate matching the signing private key. Secret: omit it, or send *****, to keep the stored value.
- `assertion_ttl_seconds` (long, optional) — How long, in seconds, an issued assertion is valid. Defaults to 300.
- `online_flow` (SamlOnlineFlowSettingsPatch, optional) — Build the assertion from the user's assertion issued and signed by your identity provider.
- `offline_flow` (SamlOfflineFlowSettingsPatch, optional) — Build the assertion from static attributes and the requesting user's record, without contacting an identity provider.

### OAuth2ResponseOptionsSettings

- `text` (boolean, optional) — If true, the token is the entire response body rather than a JSON object.
- `json` (OAuth2JsonResponseSettings, optional) — Keys to read when the token response is a JSON object with non-standard keys.

### OAuth2RequestOptionsSettingsPatch

- `custom_grant_type` (string, optional) — Value to send as grant_type instead of the selected grant's standard value.
- `additional_headers` (list of OAuth2HeaderSettingsPatch, optional) — Additional headers sent on the token request.
- `additional_request_data` (list of OAuth2RequestDataSettingsPatch, optional) — Additional body fields sent on the token request.

### JwtClaimsSettings

- `expiry_seconds` (integer, optional) — Token lifetime in seconds from issue, used for the exp claim. Must be 0 or greater.
- `issuer` (string, optional) — Issuer of the token (iss claim).
- `audience` (string, optional) — Audience of the token (aud claim).
- `subject` (string, optional) — Subject of the token (sub claim).
- `jti_enabled` (boolean, optional) — If true, each token includes a unique jti claim.

### JwtHeaderSettingsPatch

- `key` (string, optional) — Header parameter or claim name.
- `value` (string, optional) — Header parameter or claim value. Secret: omit it, or send *****, to keep the stored value.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### JwksAuthSettingsPatchRotationGracePeriodHours

Hours the previous key stays valid after a rotation. 0 uses the default.

- integer
- string

### JwksAuthSettingsPatchRotationIntervalDays

Days between key rotations. 0 uses the default of 30 days.

- integer
- string

### TemplatedSecretSettingsPatch

- `pattern` (string, optional) — Value template, with %s replaced by the secret, for example Bearer %s.
- `secret` (string, optional) — Secret inserted into the pattern. Secret: omit it, or send *****, to keep the stored value.

### OAuth2ClientCredentialsGrantSettings

- `client_id` (string, optional) — Client ID issued by the authorization server.
- `client_secret` (string, optional) — Client secret issued by the authorization server. Secret: always returned masked as *****.
- `scope` (string, optional) — Scope to request from the authorization server.

### OAuth2PasswordGrantSettings

- `client_id` (string, optional) — Client ID issued by the authorization server.
- `client_secret` (string, optional) — Client secret issued by the authorization server. Secret: always returned masked as *****.
- `username` (string, optional) — Username of the account the token is requested for.
- `password` (string, optional) — Password of the account the token is requested for. Secret: always returned masked as *****.

### OAuth2RefreshTokenGrantSettings

- `client_id` (string, optional) — Client ID issued by the authorization server.
- `client_secret` (string, optional) — Client secret issued by the authorization server. Secret: always returned masked as *****.
- `refresh_token` (string, optional) — Refresh token used to obtain access tokens. Secret: always returned masked as *****.
- `scope` (string, optional) — Scope to request from the authorization server.

### OAuth2AuthorizationCodeGrantSettings

- `authorization_url` (string, optional) — Authorization endpoint URL of the authorization server, where users sign in and grant access.
- `client_id` (string, optional) — Client ID issued by the authorization server.
- `client_secret` (string, optional) — Client secret issued by the authorization server. Secret: always returned masked as *****.
- `scope` (string, optional) — Scope to request from the authorization server.
- `authorization_query_params` (list of AuthorizationQueryParamSettings, optional) — Additional query parameters added to the authorization request.
- `revoke_access_token_options` (OAuth2RevokeAccessTokenOptionsSettings, optional) — How to revoke a user's access token when they disconnect.
- `refresh_access_token_options` (OAuth2RefreshAccessTokenOptionsSettings, optional) — Options for refreshing access tokens.
- `pkce_algorithm` (string, optional) — PKCE code challenge method. One of: SHA256, PLAIN. Leave unset to disable PKCE. SHA256 is recommended; use PLAIN only if the server does not support S256.
- `on_premise_service_name` (string, optional) — Service name configured in the Moveworks on-premise agent, for connectors routed through that agent. Setting it also skips the public-host check on base_url.

### OAuth2SamlBearerGrantSettings

- `issuer` (string, optional) — SAML entity ID that Moveworks issues assertions as. Required for this grant.
- `client_id` (string, optional) — Client ID issued by the authorization server.
- `target_audience` (string, optional) — Entity ID of the target system, placed in the assertion's audience.
- `target_recipient` (string, optional) — URL that receives the assertion, typically the token endpoint.
- `signing_private_key` (string, optional) — PEM private key used to sign the assertions. Secret: always returned masked as *****.
- `signing_certificate` (string, optional) — X.509 certificate matching the signing private key. Secret: always returned masked as *****.
- `assertion_ttl_seconds` (long, optional) — How long, in seconds, an issued assertion is valid. Defaults to 300.
- `online_flow` (SamlOnlineFlowSettings, optional) — Build the assertion from the user's assertion issued and signed by your identity provider.
- `offline_flow` (SamlOfflineFlowSettings, optional) — Build the assertion from static attributes and the requesting user's record, without contacting an identity provider.

### OAuth2RequestOptionsSettings

- `custom_grant_type` (string, optional) — Value to send as grant_type instead of the selected grant's standard value.
- `additional_headers` (list of OAuth2HeaderSettings, optional) — Additional headers sent on the token request.
- `additional_request_data` (list of OAuth2RequestDataSettings, optional) — Additional body fields sent on the token request.

### JwtHeaderSettings

- `key` (string, optional) — Header parameter or claim name.
- `value` (string, optional) — Header parameter or claim value. Secret: always returned masked as *****.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### JwksAuthSettingsRotationGracePeriodHours

Hours the previous key stays valid after a rotation. 0 uses the default.

- integer
- string

### JwksAuthSettingsRotationIntervalDays

Days between key rotations. 0 uses the default of 30 days.

- integer
- string

### TemplatedSecretSettings

- `pattern` (string, optional) — Value template, with %s replaced by the secret, for example Bearer %s.
- `secret` (string, optional) — Secret inserted into the pattern. Secret: always returned masked as *****.

### AuthorizationQueryParamSettingsPatch

- `key` (string, optional) — Query parameter name.
- `value` (string, optional) — Query parameter value.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### OAuth2RevokeAccessTokenOptionsSettingsPatch

- `revoke_url` (string, optional) — Token revocation endpoint URL.
- `revoke_instructions_url` (string, optional) — URL of instructions shown to the user when revocation fails.
- `revoke_access_token_authentication` (string, optional) — How the access token is passed to the revocation endpoint. One of: BODY, URL_PARAMETERS, TOKEN_AUTH, BASIC_AUTH.
- `revocation_token_key` (string, optional) — Name of the request body field that carries the token. Defaults to token.
- `revocation_headers` (list of OAuth2HeaderSettingsPatch, optional) — Additional headers sent on the revocation request.
- `revocation_method` (string, optional) — HTTP method of the revocation request. One of: GET, POST, PUT, DELETE, PATCH.

### OAuth2RefreshAccessTokenOptionsSettings

- `scope_disabled` (boolean, optional) — If true, the scope parameter is omitted from refresh token requests.

### SamlOnlineFlowSettingsPatch

- `saml_idp_url` (string, optional) — Identity provider endpoint that issues the user's assertion.
- `idp_signing_certificate` (string, optional) — X.509 signing certificate of the identity provider, used to verify its assertions. Secret: omit it, or send *****, to keep the stored value.
- `expected_audience` (string, optional) — Audience the identity provider's assertion must carry (the Moveworks entity ID).
- `attribute_mappings` (list of SamlAttributeMappingSettingsPatch, optional) — Mappings from identity provider attributes to target system attributes.

### SamlOfflineFlowSettingsPatch

- `static_attributes` (list of SamlStaticAttributeSettingsPatch, optional) — Attributes included unchanged in every assertion.

### OAuth2JsonResponseSettings

- `expires_in_key` (string, optional) — Response key that holds the token expiry. Defaults to expires_in.
- `access_token_key` (string, optional) — Response key that holds the access token. Defaults to access_token.
- `expires_in_format` (string, optional) — How the expiry value is encoded. One of: SECONDS, DATE. Defaults to SECONDS.

### OAuth2HeaderSettingsPatch

- `key` (string, optional) — Header name.
- `value` (string, optional) — Header value.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### OAuth2RequestDataSettingsPatch

- `key` (string, optional) — Body field name.
- `value` (string, optional) — Body field value.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### AuthorizationQueryParamSettings

- `key` (string, optional) — Query parameter name.
- `value` (string, optional) — Query parameter value.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### OAuth2RevokeAccessTokenOptionsSettings

- `revoke_url` (string, optional) — Token revocation endpoint URL.
- `revoke_instructions_url` (string, optional) — URL of instructions shown to the user when revocation fails.
- `revoke_access_token_authentication` (string, optional) — How the access token is passed to the revocation endpoint. One of: BODY, URL_PARAMETERS, TOKEN_AUTH, BASIC_AUTH.
- `revocation_token_key` (string, optional) — Name of the request body field that carries the token. Defaults to token.
- `revocation_headers` (list of OAuth2HeaderSettings, optional) — Additional headers sent on the revocation request.
- `revocation_method` (string, optional) — HTTP method of the revocation request. One of: GET, POST, PUT, DELETE, PATCH.

### SamlOnlineFlowSettings

- `saml_idp_url` (string, optional) — Identity provider endpoint that issues the user's assertion.
- `idp_signing_certificate` (string, optional) — X.509 signing certificate of the identity provider, used to verify its assertions. Secret: always returned masked as *****.
- `expected_audience` (string, optional) — Audience the identity provider's assertion must carry (the Moveworks entity ID).
- `attribute_mappings` (list of SamlAttributeMappingSettings, optional) — Mappings from identity provider attributes to target system attributes.

### SamlOfflineFlowSettings

- `static_attributes` (list of SamlStaticAttributeSettings, optional) — Attributes included unchanged in every assertion.

### OAuth2HeaderSettings

- `key` (string, optional) — Header name.
- `value` (string, optional) — Header value.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### OAuth2RequestDataSettings

- `key` (string, optional) — Body field name.
- `value` (string, optional) — Body field value.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### SamlAttributeMappingSettingsPatch

- `key` (string, optional) — Attribute name in the target system.
- `value` (string, optional) — Attribute name in the identity provider's assertion.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### SamlStaticAttributeSettingsPatch

- `key` (string, optional) — Attribute name.
- `value` (string, optional) — Attribute value.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### SamlAttributeMappingSettings

- `key` (string, optional) — Attribute name in the target system.
- `value` (string, optional) — Attribute name in the identity provider's assertion.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

### SamlStaticAttributeSettings

- `key` (string, optional) — Attribute name.
- `value` (string, optional) — Attribute value.
- `item_ref` (string, optional) — Row identifier assigned by the server. Leave unset on create; on update, send back the value from your last read so the row is matched correctly.

## Examples

### HTTP Connectors endpoints_updateHTTPConnector_example

**Response**

```json
{
  "id": "3f6c1e2a-8b4d-4c7e-9a1f-2d5b6c7e8f90",
  "name": "erp_production",
  "base_url": "https://erp.example.com/v2",
  "api_key_auth": {
    "api_key": "••••••••",
    "header": {
      "key": "X-API-Key",
      "value_pattern": "%s"
    }
  },
  "headers": [
    {
      "key": "Accept",
      "value": "application/json"
    }
  ],
  "updated_time": "2026-11-12T18:04:11Z",
  "updated_by": "admin@example.com",
  "version": {
    "num": 3,
    "change_description": "Update the HTTP connector"
  }
}
```

**SDK Code**

```python HTTP Connectors endpoints_updateHTTPConnector_example
import requests

url = "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id"

headers = {"Authorization": "Bearer <token>"}

response = requests.patch(url, headers=headers)

print(response.json())
```

```javascript HTTP Connectors endpoints_updateHTTPConnector_example
const url = 'https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id';
const options = {method: 'PATCH', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go HTTP Connectors endpoints_updateHTTPConnector_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id"

	req, _ := http.NewRequest("PATCH", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby HTTP Connectors endpoints_updateHTTPConnector_example
require 'uri'
require 'net/http'

url = URI("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java HTTP Connectors endpoints_updateHTTPConnector_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.patch("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php HTTP Connectors endpoints_updateHTTPConnector_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp HTTP Connectors endpoints_updateHTTPConnector_example
using RestSharp;

var client = new RestClient("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id");
var request = new RestRequest(Method.PATCH);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift HTTP Connectors endpoints_updateHTTPConnector_example
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "PATCH"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Change a HTTP connector

**Request**

```json
{
  "version": {
    "num": 2,
    "change_description": "Update the HTTP connector"
  },
  "base_url": "https://erp.example.com/v2"
}
```

**Response**

```json
{
  "id": "3f6c1e2a-8b4d-4c7e-9a1f-2d5b6c7e8f90",
  "name": "erp_production",
  "base_url": "https://erp.example.com/v2",
  "api_key_auth": {
    "api_key": "••••••••",
    "header": {
      "key": "X-API-Key",
      "value_pattern": "%s"
    }
  },
  "headers": [
    {
      "key": "Accept",
      "value": "application/json"
    }
  ],
  "updated_time": "2026-11-12T18:04:11Z",
  "updated_by": "admin@example.com",
  "version": {
    "num": 3,
    "change_description": "Update the HTTP connector"
  }
}
```

**SDK Code**

```python Change a HTTP connector
import requests

url = "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id"

payload = {
    "version": {
        "num": 2,
        "change_description": "Update the HTTP connector"
    },
    "base_url": "https://erp.example.com/v2"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.json())
```

```javascript Change a HTTP connector
const url = 'https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id';
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"version":{"num":2,"change_description":"Update the HTTP connector"},"base_url":"https://erp.example.com/v2"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Change a HTTP connector
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id"

	payload := strings.NewReader("{\n  \"version\": {\n    \"num\": 2,\n    \"change_description\": \"Update the HTTP connector\"\n  },\n  \"base_url\": \"https://erp.example.com/v2\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Change a HTTP connector
require 'uri'
require 'net/http'

url = URI("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"version\": {\n    \"num\": 2,\n    \"change_description\": \"Update the HTTP connector\"\n  },\n  \"base_url\": \"https://erp.example.com/v2\"\n}"

response = http.request(request)
puts response.read_body
```

```java Change a HTTP connector
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.patch("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"version\": {\n    \"num\": 2,\n    \"change_description\": \"Update the HTTP connector\"\n  },\n  \"base_url\": \"https://erp.example.com/v2\"\n}")
  .asString();
```

```php Change a HTTP connector
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id', [
  'body' => '{
  "version": {
    "num": 2,
    "change_description": "Update the HTTP connector"
  },
  "base_url": "https://erp.example.com/v2"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Change a HTTP connector
using RestSharp;

var client = new RestClient("https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id");
var request = new RestRequest(Method.PATCH);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"version\": {\n    \"num\": 2,\n    \"change_description\": \"Update the HTTP connector\"\n  },\n  \"base_url\": \"https://erp.example.com/v2\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Change a HTTP connector
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "version": [
    "num": 2,
    "change_description": "Update the HTTP connector"
  ],
  "base_url": "https://erp.example.com/v2"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.moveworks.ai/configurations/v1alpha1/platform/extensions/http-connectors/id")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "PATCH"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```