HTTP Connectors
platform.extensions.http-connectors
An HTTP connector holds the base URL and credentials for one external API. HTTP actions and MCP servers call that API through it, so create the connector first.
To learn what HTTP connectors do, see HTTP Connectors in the Tool Studio docs.
- Endpoint:
/platform/extensions/http-connectors| Methods: GET, PATCH, POST - Request shape: fields go at the top level of the JSON body, with no
resourcewrapper. The item’sidgoes in the URL for reads and updates, not in the body. - Updates: a JSON merge-patch with
version: {num, change_description}from your last read. Lists of objects merge row by row, so read first and send the whole list when you remove or reorder rows. See Tool Studio. - References: Referenced by HTTP actions and MCP servers through
connector_id, which takes the connector’sid.
Endpoints
All paths are relative to https://api.moveworks.ai/configurations/v1alpha1. Each endpoint page lists the request and response schema, an example, and the errors it can return.
Rules the API checks
nameis unique in your organization and can’t be changed after creation.base_urlis the scheme, host and any fixed path prefix, with no trailing/and no query string. Put query parameters for every request inquery_params.- Set exactly one auth block:
no_auth,basic_auth,api_key_auth,oauth2,jwt_authorjwks_auth. - Secrets (
password,api_key,client_secret,private_key) are sent in plain text and come back redacted. You can’t read them back.
Fields
Set at most one of basic_auth, api_key_auth, oauth2, jwt_auth, jwks_auth, no_auth.
Variants (6, pick one)
basic_auth
HTTP basic authentication with a username and password.
api_key_auth
API key authentication, sent in a header or query parameter.
In api_key_auth, set at most one of query_param, header.
oauth2
OAuth 2.0 authentication.
In oauth2, set at most one of client_credentials_grant, password_grant, refresh_token_grant, jwt_grant, authorization_code_grant, saml_bearer_grant, jwks_grant.
jwt_auth
JWT bearer authentication signed with a private key you provide.
jwks_auth
JWT bearer authentication signed with a key pair that Moveworks generates and rotates.
no_auth
No authentication. Set to an empty object to send requests without credentials.