---
title: "Update a connector."
method: PATCH
path: "/v1/connectors/{connector_id}#id"
tags: ["beta.connectors"]
---

# Update a connector.

`PATCH /v1/connectors/{connector_id}#id`

Update a connector by its ID.

## Path parameters

- `connector_id` string, uuid, required

## Request body

- UpdateConnectorRequest
  - `title` string, nullable — Optional human-readable title for the connector.
  - `name` string, nullable — The name of the connector.
  - `description` string, nullable — The description of the connector.
  - `icon_url` string, nullable — The optional url of the icon you want to associate to the connector.
  - `system_prompt` string, nullable — Optional system prompt for the connector.
  - `protocol` 'mcp'
  - `server` string, uri, nullable — New server url for your mcp connector.
  - `auth_methods` AuthenticationMethodCreateOrUpdateRequest[], nullable — list of authentication methods to add to the connector or to update
    - `method_type` union, required — The type of authentication method (e.g. oauth2, bearer, none).
      - 'oauth2' | 'bearer' | 'none' | 'github_app' | 'slack_app'
      - 'webhook'
    - `auth_direction` 'inbound' | 'outbound'
    - `headers` ConnectorAuthenticationHeader[], nullable — Set of headers to connect to the connector
      - `name` string, required
      - `is_required` boolean
      - `is_secret` boolean
    - `global_headers` object — Connector-wide headers keyed by header name, applied to every credential. Secret values are encrypted at rest and never returned in clear.
    - `oauth2_metadata_secrets` Oauth2MetadataSecrets — OAuth2 client credentials stored alongside a connector's authentication method. Used by OAuth2 and Slack App auth types for token exchange and refresh flows. Contains the client credentials obtained during OAuth2 Dynamic Client Registration or provided at connector creation time.
      - `client_id` string, nullable
      - `client_secret` string, password, nullable
      - `client_id_issued_at` integer, nullable
      - `client_secret_expires_at` integer, nullable
    - `oauth2_server_metadata` ExtendedOAuthServerMetadata — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
      - `issuer` string, uri, required
      - `authorization_endpoint` string, uri, required
      - `token_endpoint` string, uri, required
      - `registration_endpoint` string, uri, nullable
      - `scopes_supported` string[], nullable
      - `response_types_supported` string[]
      - `response_modes_supported` string[], nullable
      - `grant_types_supported` string[], nullable
      - `token_endpoint_auth_methods_supported` string[], nullable
      - `token_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `service_documentation` string, uri, nullable
      - `ui_locales_supported` string[], nullable
      - `op_policy_uri` string, uri, nullable
      - `op_tos_uri` string, uri, nullable
      - `revocation_endpoint` string, uri, nullable
      - `revocation_endpoint_auth_methods_supported` string[], nullable
      - `revocation_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `introspection_endpoint` string, uri, nullable
      - `introspection_endpoint_auth_methods_supported` string[], nullable
      - `introspection_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `code_challenge_methods_supported` string[], nullable
      - `client_id_metadata_document_supported` boolean, nullable
      - `x_source` 'autodiscovery' | 'provided' — How a connector's OAuth server metadata was obtained.
      - `x_resource_url` string, nullable
      - `x_scope` string, nullable

## Response `200`

Successful Response

- Connector
  - `id` string, uuid, required
  - `name` string, required
  - `title` string, nullable
  - `description` string, required
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `server` string, nullable
  - `protocol` 'mcp' | 'http' | 'turbine'
  - `icon_url` string, nullable
  - `server_card` MCPServerCard
    - `$schema` string, nullable — URL to the JSON schema definition
    - `name` string, required — Server identifier in reverse-DNS format with exactly one /
    - `version` string, required — Server version (semantic versioning preferred)
    - `capabilities` ServerCapabilities — Capabilities that a server may support.
      - `experimental` object, nullable
      - `logging` LoggingCapability — Capability for logging operations.
      - `prompts` PromptsCapability — Capability for prompts operations.
        - `listChanged` boolean, nullable
      - `resources` ResourcesCapability — Capability for resources operations.
        - `subscribe` boolean, nullable
        - `listChanged` boolean, nullable
      - `tools` ToolsCapability — Capability for tools operations.
        - `listChanged` boolean, nullable
      - `completions` CompletionsCapability — Capability for completions operations.
      - `tasks` ServerTasksCapability — Capability for server tasks operations.
        - `list` TasksListCapability — Capability for tasks listing operations.
        - `cancel` TasksCancelCapability — Capability for tasks cancel operations.
        - `requests` ServerTasksRequestsCapability — Capability for tasks requests operations.
          - `tools` TasksToolsCapability — Capability for tasks tools operations.
            - `call` TasksCallCapability — Capability for tasks call operations.
    - `title` string, nullable
    - `description` string, nullable
    - `websiteUrl` string, nullable
    - `repository` MCPServerRepository — Source repository information (SEP-2127).
      - `url` string, required — Repository URL
      - `source` string, required — Source identifier (e.g. 'github')
      - `subfolder` string, nullable
    - `icons` MCPServerIcon[], nullable
      - `src` string, required
      - `mimeType` string, nullable
      - `sizes` string[], nullable
    - `remotes` MCPServerRemote[], nullable
      - `type` 'streamable-http' | 'sse', required — Transport type
      - `url` string, required — Transport endpoint URL
      - `supportedProtocolVersions` string[], nullable
      - `headers` MCPServerRemoteHeader[], nullable
        - `name` string, required — Header name
        - `description` string, required — Human-readable description of the header
        - `isRequired` boolean, nullable
        - `isSecret` boolean, nullable
        - `default` string, nullable
        - `choices` string[], nullable
      - `authentication` MCPServerAuthenticationRequirement — Authentication requirements for a remote transport (SEP-2127).
        - `required` boolean, required — Whether authentication is mandatory
        - `schemes` string[] — Supported schemes (e.g. ['bearer', 'oauth2'])
    - `requires` ClientCapabilities — Capabilities a client may support.
      - `experimental` object, nullable
      - `sampling` SamplingCapability — Sampling capability structure, allowing fine-grained capability advertisement.
        - `context` SamplingContextCapability — Capability for context inclusion during sampling. Indicates support for non-'none' values in the includeContext parameter. SOFT-DEPRECATED: New implementations should use tools parameter instead.
        - `tools` SamplingToolsCapability — Capability indicating support for tool calling during sampling. When present in ClientCapabilities.sampling, indicates that the client supports the tools and toolChoice parameters in sampling requests.
      - `elicitation` ElicitationCapability — Capability for elicitation operations. Clients must support at least one mode (form or url).
        - `form` FormElicitationCapability — Capability for form mode elicitation.
        - `url` UrlElicitationCapability — Capability for URL mode elicitation.
      - `roots` RootsCapability — Capability for root operations.
        - `listChanged` boolean, nullable
      - `tasks` ClientTasksCapability — Capability for client tasks operations.
        - `list` TasksListCapability — Capability for tasks listing operations.
        - `cancel` TasksCancelCapability — Capability for tasks cancel operations.
        - `requests` ClientTasksRequestsCapability — Capability for tasks requests operations.
          - `sampling` TasksSamplingCapability — Capability for tasks sampling operations.
            - `createMessage` TasksCreateMessageCapability — Capability for tasks create messages.
          - `elicitation` TasksElicitationCapability — Capability for tasks elicitation operations.
            - `create` TasksCreateElicitationCapability — Capability for tasks create elicitation operations.
    - `resources` union
      - 'dynamic'
      - MCPResource[]
        - `name` string, required
        - `title` string, nullable
        - `uri` string, uri, required
        - `description` string, nullable
        - `mimeType` string, nullable
        - `size` integer, nullable
        - `icons` MCPServerIcon[], nullable
          - `src` string, required
          - `mimeType` string, nullable
          - `sizes` string[], nullable
        - `annotations` Annotations
          - `audience` string[], nullable
          - `priority` number, nullable
        - `_meta` object, nullable
    - `tools` union
      - 'dynamic'
      - MCPServerCardTool[]
        - `name` string, required
        - `title` string, nullable
        - `description` string, nullable
        - `inputSchema` object, required
        - `outputSchema` object, nullable
        - `icons` MCPServerIcon[], nullable
          - `src` string, required
          - `mimeType` string, nullable
          - `sizes` string[], nullable
        - `annotations` ToolAnnotations — Additional properties describing a Tool to clients. NOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`). Clients should never make tool use decisions based on ToolAnnotations received from untrusted servers.
          - `title` string, nullable
          - `readOnlyHint` boolean, nullable
          - `destructiveHint` boolean, nullable
          - `idempotentHint` boolean, nullable
          - `openWorldHint` boolean, nullable
        - `_meta` MCPToolMeta — Typed _meta for MCP tools. Only the 'ui' field is typed. Other fields are allowed via extra="allow".
          - `ui` MCPUIToolMeta — UI metadata for tools that reference UI resources.
            - `resourceUri` string, nullable
            - `visibility` string[], nullable
          - `ai.mistral/turbine` TurbineToolMeta
            - `locale` TurbineToolLocale
              - …
            - `tool_type` 'rag' | 'image' | 'code' | 'event'
            - `timeout` number, nullable
            - `private_execution` boolean, nullable
        - `execution` ToolExecution — Execution-related properties for a tool.
          - `taskSupport` 'forbidden' | 'optional' | 'required', nullable
    - `prompts` union
      - 'dynamic'
      - MCPPrompt[]
        - `name` string, required
        - `title` string, nullable
        - `description` string, nullable
        - `arguments` PromptArgument[], nullable
          - `name` string, required
          - `description` string, nullable
          - `required` boolean, nullable
        - `icons` MCPServerIcon[], nullable
          - `src` string, required
          - `mimeType` string, nullable
          - `sizes` string[], nullable
        - `_meta` object, nullable
    - `_meta` MCPServerCardMeta — Typed _meta for MCP server cards. Only the 'turbine' field is typed. Other fields are allowed via extra="allow".
      - `ai.mistral/turbine` TurbineMeta
        - `system_prompt_name` string, nullable
        - `locale` ServerLocale
          - `name` object, nullable
          - `description` object, nullable
          - `usage_sentence` object, nullable
          - `working_description` object, nullable
          - `done_description` object, nullable
  - `owner_id` string, nullable
  - `owner_type` 'user' | 'org' | 'workspace' | 'system', required
  - `visibility` 'shared_global' | 'shared_org' | 'shared_workspace' | 'private', required
  - `creator_id` string, nullable
  - `locale` ConnectorLocale
    - `name` object, required
    - `description` object, required
    - `usage_sentence` object, required
  - `system_prompt` string, nullable
  - `supported_auth_methods` PublicAuthenticationMethod[], nullable
    - `method_type` 'oauth2' | 'bearer' | 'none' | 'github_app' | 'slack_app', required
    - `headers` ConnectorAuthenticationHeader[], nullable
      - `name` string, required
      - `is_required` boolean
      - `is_secret` boolean
    - `global_headers` object
    - `has_default_credentials` boolean, required
    - `oauth2_server_metadata` ExtendedOAuthServerMetadata — Custom superset of RFC 8414 OAuth 2.0 Authorization Server Metadata. Stored at connector creation time (provided for HTTP connectors, discovered via .well-known for MCP). Mirrors the shape of .well-known/oauth-authorization-server responses.
      - `issuer` string, uri, required
      - `authorization_endpoint` string, uri, required
      - `token_endpoint` string, uri, required
      - `registration_endpoint` string, uri, nullable
      - `scopes_supported` string[], nullable
      - `response_types_supported` string[]
      - `response_modes_supported` string[], nullable
      - `grant_types_supported` string[], nullable
      - `token_endpoint_auth_methods_supported` string[], nullable
      - `token_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `service_documentation` string, uri, nullable
      - `ui_locales_supported` string[], nullable
      - `op_policy_uri` string, uri, nullable
      - `op_tos_uri` string, uri, nullable
      - `revocation_endpoint` string, uri, nullable
      - `revocation_endpoint_auth_methods_supported` string[], nullable
      - `revocation_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `introspection_endpoint` string, uri, nullable
      - `introspection_endpoint_auth_methods_supported` string[], nullable
      - `introspection_endpoint_auth_signing_alg_values_supported` string[], nullable
      - `code_challenge_methods_supported` string[], nullable
      - `client_id_metadata_document_supported` boolean, nullable
      - `x_source` 'autodiscovery' | 'provided' — How a connector's OAuth server metadata was obtained.
      - `x_resource_url` string, nullable
      - `x_scope` string, nullable
  - `connection_preferences` ConnectionPreference[], nullable
    - `name` string, required
    - `tool_configuration` ToolExecutionConfiguration, required
      - `requires_confirmation` union
        - string[]
        - LogicalExpression
          - `type` 'and' | 'or', required
          - `expressions` union[], required
            - union
              - …
        - ToolProperties
          - `read_only` boolean, nullable, required
      - `skip_confirmation` union
        - string[]
        - LogicalExpression
          - `type` 'and' | 'or', required
          - `expressions` union[], required
            - union
              - …
        - ToolProperties
          - `read_only` boolean, nullable, required
      - `include` string[], nullable
      - `exclude` string[], nullable
    - `is_default` boolean, nullable
    - `consumer_type` 'user' | 'org' | 'workspace' | 'system'
  - `connection_credentials` AuthenticationConfiguration[], nullable
    - `name` string, required
    - `title` string, nullable
    - `authentication_type` 'oauth2' | 'bearer' | 'none' | 'github_app' | 'slack_app', required
    - `scope` 'user' | 'org' | 'workspace' | 'system', required
    - `status` CredentialsStatus
      - `status_type` 'valid' | 'invalid' | 'error', required
      - `last_checked_at` string, date-time, nullable
      - `error_http_code` 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511 — HTTP status codes and reason phrases Status codes from the following RFCs are all observed: * RFC 7231: Hypertext Transfer Protocol (HTTP/1.1), obsoletes 2616 * RFC 6585: Additional HTTP Status Codes * RFC 3229: Delta encoding in HTTP * RFC 4918: HTTP Extensions for WebDAV, obsoletes 2518 * RFC 5842: Binding Extensions to WebDAV * RFC 7238: Permanent Redirect * RFC 2295: Transparent Content Negotiation in HTTP * RFC 2774: An HTTP Extension Framework * RFC 7725: An HTTP Status Code to Report Legal Obstacles * RFC 7540: Hypertext Transfer Protocol Version 2 (HTTP/2) * RFC 2324: Hyper Text Coffee Pot Control Protocol (HTCPCP/1.0) * RFC 8297: An HTTP Status Code for Indicating Hints * RFC 8470: Using Early Data in HTTP
      - `error_message` 'oauth expired' | 'oauth near expiry' | 'empty credentials' | 'unparsable credentials' | 'you need to reconnect' | 'oauth refresh error' | 'MCP server unreachable' | 'MCP server timed out' | 'MCP server error' | 'unknown error'
    - `is_default` boolean
  - `active` boolean, nullable
  - `private_tool_execution` boolean, required
  - `mistral` boolean
  - `is_authenticated` boolean, nullable
  - `tools` ConnectorTool[], nullable
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `system_prompt` string, nullable
    - `locale` ConnectorToolLocale
      - `name` object, required
      - `description` object, required
      - `usage_sentence` object, required
    - `jsonschema` object, nullable
    - `execution_config` ExecutionConfig, required — Not typed since mcp config can changed / not stable we allow all extra fields and this is a dict TODO: once mcp is stable, we need to type this
      - `type` string, required
    - `visibility` 'shared_global' | 'shared_org' | 'shared_workspace' | 'private', required
    - `created_at` string, date-time, required
    - `modified_at` string, date-time, required
    - `active` boolean, nullable
  - `system_prompt_route` string, nullable
  - `connection_config` PublicConnectionConfig
    - `type` 'mcp' | 'turbine' | 'eolienne'
    - `base_url` string, nullable
    - `headers` object, nullable
    - `signed` boolean, nullable
  - `execution_env` PublicExecutionEnv — Credentials-free projection of ExecutionEnv for the public /connectors/mistral response.
    - `tools` Tool[], required
      - `type` 'function'
      - `function` Function, required
        - `name` string, required
        - `description` string
        - `strict` boolean
        - `parameters` object, required
    - `tool_execution_data` PublicConnectorExecutionData, required
      - `integrations` PublicExecutionConnector[], required
        - `id` string, uuid, required
        - `name` string, required
        - `connection_config` PublicExecutionConnectionConfig, required — Connection config exposed in the public, unauthenticated /connectors/mistral response. Unlike ConnectionConfig, this has no `headers` field and forbids extra fields, so connector credentials can never be serialized into this cacheable response.
          - `type` 'mcp' | 'turbine' | 'eolienne', required
          - `server` string, nullable
          - `name` string, nullable
          - `id` string, nullable
          - `tool_configuration` ToolExecutionConfiguration
            - `requires_confirmation` union
              - …
            - `skip_confirmation` union
              - …
            - `include` string[], nullable
            - `exclude` string[], nullable
          - `hosted_internally` boolean
      - `tools` ExecutionTool[], required
        - `name` string, required
        - `integration_id` string, uuid, required
        - `execution_config` ExecutionConfig, required — Not typed since mcp config can changed / not stable we allow all extra fields and this is a dict TODO: once mcp is stable, we need to type this
          - `type` string, required
      - `use_connectors_gateway` boolean
    - `errors` string[], required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/61436a496404/schema)