---
title: "Get a connector."
method: GET
path: "/v1/connectors/{connector_id_or_name}#idOrName"
tags: ["beta.connectors"]
---

# Get a connector.

`GET /v1/connectors/{connector_id_or_name}#idOrName`

## Request

- Base URL: `https://api.mistral.ai`
- URL: `https://api.mistral.ai/v1/connectors/{connector_id_or_name}#idOrName`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mistral/apis/mistral-ai-api/docs/v1/connectors/:connector_id_or_name%23idOrName/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a connector by its ID or name.

## Path parameters

- `connector_id_or_name` union, required
  - string, uuid
  - string

## Query parameters

- `fetch_user_data` boolean: Fetch the user-level data associated with the connector (e.g. connection credentials).

## Response `200`

Successful Response

- union
  - MCPConnector
    - `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
    - `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. Not a closed set.
        - `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.
        - `extensions` object, nullable
        - `tasks` ServerTasksCapability: Capability for server tasks operations (2025-11-25 only).
          - `list` TasksListCapability: Capability for tasks listing operations (2025-11-25 only).
          - `cancel` TasksCancelCapability: Capability for tasks cancel operations (2025-11-25 only).
          - `requests` ServerTasksRequestsCapability: Specifies which request types the server can augment with tasks (2025-11-25 only).
            - `tools` TasksToolsCapability: Capability for task-augmented tool operations (2025-11-25 only).
              - …
      - `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
        - `theme` 'light' | 'dark', 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. Not a closed set: any client can define additional capabilities. Sent once in `initialize` through 2025-11-25; per-request in `_meta` on 2026-07-28.
        - `experimental` object, nullable
        - `sampling` SamplingCapability: Sampling capability structure. Deprecated in 2026-07-28 (SEP-2577); shape unchanged.
          - `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 (2025-11-25+).
        - `roots` RootsCapability: Capability for root operations. Deprecated in protocol 2026-07-28 (SEP-2577) but still carried there as an empty object (`list_changed` exists only through 2025-11-25).
          - `listChanged` boolean, nullable
        - `extensions` object, nullable
        - `tasks` ClientTasksCapability: Capability for client tasks operations (2025-11-25 only).
          - `list` TasksListCapability: Capability for tasks listing operations (2025-11-25 only).
          - `cancel` TasksCancelCapability: Capability for tasks cancel operations (2025-11-25 only).
          - `requests` ClientTasksRequestsCapability: Specifies which request types the client can augment with tasks (2025-11-25 only).
            - `sampling` TasksSamplingCapability: Capability for task-augmented sampling operations (2025-11-25 only).
              - …
            - `elicitation` TasksElicitationCapability: Capability for task-augmented elicitation operations (2025-11-25 only).
              - …
      - `resources` union
        - 'dynamic'
        - MCPResource[]
          - `name` string, required
          - `title` string, nullable
          - `uri` string, required
          - `description` string, nullable
          - `mimeType` string, nullable
          - `size` integer, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
            - `theme` 'light' | 'dark', nullable
          - `annotations` Annotations: Optional annotations the client can use to inform how objects are used or displayed.
            - `audience` string[], nullable
            - `priority` number, nullable
            - `lastModified` string, nullable
          - `_meta` object, nullable
      - `tools` union
        - 'dynamic'
        - MCPServerCardTool[]
          - `name` string, required
          - `title` string, nullable
          - `description` string, nullable
          - `inputSchema` object, required
          - `execution` ToolExecution: Execution-related properties for a tool (2025-11-25 only).
            - `taskSupport` 'forbidden' | 'optional' | 'required', nullable
          - `outputSchema` object, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
            - `theme` 'light' | 'dark', 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.
              - …
            - `ai.mistral/turbine` TurbineToolMeta
              - …
      - `prompts` union
        - 'dynamic'
        - MCPPrompt[]
          - `name` string, required
          - `title` string, nullable
          - `description` string, nullable
          - `arguments` PromptArgument[], nullable
            - `name` string, required
            - `title` string, nullable
            - `description` string, nullable
            - `required` boolean, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
            - `theme` 'light' | 'dark', 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
      - `grant_type` 'authorization_code' | 'client_credentials'
      - `token_endpoint_auth_method` 'client_secret_post' | 'client_secret_basic' | 'private_key_jwt'
      - `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, nullable
        - `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
        - `authorization_response_iss_parameter_supported` boolean, nullable
        - `authorization_grant_profiles_supported` string[], 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
              - …
          - ToolProperties
            - `read_only` boolean, nullable, required
        - `skip_confirmation` union
          - string[]
          - LogicalExpression
            - `type` 'and' | 'or', required
            - `expressions` union[], required
              - …
          - 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' | 'blank bearer token' | 'unparsable credentials' | 'you need to reconnect' | 'oauth refresh error' | 'MCP server unreachable' | 'MCP server timed out' | 'MCP server error' | 'unknown error'
      - `is_default` boolean
      - `creator_id` string, uuid, nullable
    - `blocked_by` ConsumerType[]
    - `private_tool_execution` boolean, required
    - `supports_mcp` boolean, required: Whether this connector exposes an MCP-compatible tool interface.
    - `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
    - `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
              - …
            - `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
      - `errors` string[], required
    - `protocol` 'mcp', required
  - HTTPConnector
    - `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
    - `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. Not a closed set.
        - `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.
        - `extensions` object, nullable
        - `tasks` ServerTasksCapability: Capability for server tasks operations (2025-11-25 only).
          - `list` TasksListCapability: Capability for tasks listing operations (2025-11-25 only).
          - `cancel` TasksCancelCapability: Capability for tasks cancel operations (2025-11-25 only).
          - `requests` ServerTasksRequestsCapability: Specifies which request types the server can augment with tasks (2025-11-25 only).
            - `tools` TasksToolsCapability: Capability for task-augmented tool operations (2025-11-25 only).
              - …
      - `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
        - `theme` 'light' | 'dark', 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. Not a closed set: any client can define additional capabilities. Sent once in `initialize` through 2025-11-25; per-request in `_meta` on 2026-07-28.
        - `experimental` object, nullable
        - `sampling` SamplingCapability: Sampling capability structure. Deprecated in 2026-07-28 (SEP-2577); shape unchanged.
          - `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 (2025-11-25+).
        - `roots` RootsCapability: Capability for root operations. Deprecated in protocol 2026-07-28 (SEP-2577) but still carried there as an empty object (`list_changed` exists only through 2025-11-25).
          - `listChanged` boolean, nullable
        - `extensions` object, nullable
        - `tasks` ClientTasksCapability: Capability for client tasks operations (2025-11-25 only).
          - `list` TasksListCapability: Capability for tasks listing operations (2025-11-25 only).
          - `cancel` TasksCancelCapability: Capability for tasks cancel operations (2025-11-25 only).
          - `requests` ClientTasksRequestsCapability: Specifies which request types the client can augment with tasks (2025-11-25 only).
            - `sampling` TasksSamplingCapability: Capability for task-augmented sampling operations (2025-11-25 only).
              - …
            - `elicitation` TasksElicitationCapability: Capability for task-augmented elicitation operations (2025-11-25 only).
              - …
      - `resources` union
        - 'dynamic'
        - MCPResource[]
          - `name` string, required
          - `title` string, nullable
          - `uri` string, required
          - `description` string, nullable
          - `mimeType` string, nullable
          - `size` integer, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
            - `theme` 'light' | 'dark', nullable
          - `annotations` Annotations: Optional annotations the client can use to inform how objects are used or displayed.
            - `audience` string[], nullable
            - `priority` number, nullable
            - `lastModified` string, nullable
          - `_meta` object, nullable
      - `tools` union
        - 'dynamic'
        - MCPServerCardTool[]
          - `name` string, required
          - `title` string, nullable
          - `description` string, nullable
          - `inputSchema` object, required
          - `execution` ToolExecution: Execution-related properties for a tool (2025-11-25 only).
            - `taskSupport` 'forbidden' | 'optional' | 'required', nullable
          - `outputSchema` object, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
            - `theme` 'light' | 'dark', 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.
              - …
            - `ai.mistral/turbine` TurbineToolMeta
              - …
      - `prompts` union
        - 'dynamic'
        - MCPPrompt[]
          - `name` string, required
          - `title` string, nullable
          - `description` string, nullable
          - `arguments` PromptArgument[], nullable
            - `name` string, required
            - `title` string, nullable
            - `description` string, nullable
            - `required` boolean, nullable
          - `icons` MCPServerIcon[], nullable
            - `src` string, required
            - `mimeType` string, nullable
            - `sizes` string[], nullable
            - `theme` 'light' | 'dark', 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
      - `grant_type` 'authorization_code' | 'client_credentials'
      - `token_endpoint_auth_method` 'client_secret_post' | 'client_secret_basic' | 'private_key_jwt'
      - `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, nullable
        - `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
        - `authorization_response_iss_parameter_supported` boolean, nullable
        - `authorization_grant_profiles_supported` string[], 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
              - …
          - ToolProperties
            - `read_only` boolean, nullable, required
        - `skip_confirmation` union
          - string[]
          - LogicalExpression
            - `type` 'and' | 'or', required
            - `expressions` union[], required
              - …
          - 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' | 'blank bearer token' | 'unparsable credentials' | 'you need to reconnect' | 'oauth refresh error' | 'MCP server unreachable' | 'MCP server timed out' | 'MCP server error' | 'unknown error'
      - `is_default` boolean
      - `creator_id` string, uuid, nullable
    - `blocked_by` ConsumerType[]
    - `private_tool_execution` boolean, required
    - `supports_mcp` boolean, required: Whether this connector exposes an MCP-compatible tool interface.
    - `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
    - `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
              - …
            - `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
      - `errors` string[], required
    - `protocol` 'http', required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `f42449e21ee5`: 4 breaking, 22 info
  - the `oneOf[subschema #1: MCPConnector]/server_card/anyOf[subschema #1: MCPServerCard]/resources/anyOf[subschema #2]/items/uri` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `oneOf[subschema #2: HTTPConnector]/server_card/anyOf[subschema #1: MCPServerCard]/resources/anyOf[subschema #2]/items/uri` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `oneOf[subschema #1: MCPConnector]/server_card/anyOf[subschema #1: MCPServerCard]/resources/anyOf[subschema #2]/items/uri` response's property format changed from `uri` to no format for status `200`
  - the `oneOf[subschema #2: HTTPConnector]/server_card/anyOf[subschema #1: MCPServerCard]/resources/anyOf[subschema #2]/items/uri` response's property format changed from `uri` to no format for status `200`
  - …22 more
- **2026-10-12** `6c349f3bdef6`: 7 warning
  - deleted the `query` request parameter `fetch_customer_data`
  - removed the optional property `oneOf[subschema #1: MCPConnector]/active` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: MCPConnector]/execution_env/anyOf[subschema #1: PublicExecutionEnv]/tool_execution_data/use_connectors_gateway` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: MCPConnector]/system_prompt_route` from the response with the `200` status
  - …3 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/connectors/:connector_id_or_name%23idOrName/get.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) - [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mistral/apis/mistral-ai-api/revisions/08a585fb75bc?raw)