--- title: "List all connectors." method: GET path: "/v1/connectors" tags: ["beta.connectors"] --- # List all connectors. `GET /v1/connectors` List all your custom connectors with keyset pagination and filters. ## Query parameters - `query_filters` ConnectorsQueryFilters - `active` boolean, nullable — Filter for active connectors for a given user, workspace and organization. - `supports_mcp` boolean, nullable — Filter connectors by whether they expose an MCP-compatible tool interface. - `cursor` string, nullable - `page_size` integer ## Response `200` Successful Response - PaginatedConnectors - `items` Connector[], required - 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. - `experimental` object, nullable - `logging` LoggingCapability — Capability for logging operations. - `prompts` PromptsCapability — Capability for prompts operations. - … - `resources` ResourcesCapability — Capability for resources operations. - … - `tools` ToolsCapability — Capability for tools operations. - … - `completions` CompletionsCapability — Capability for completions operations. - `tasks` ServerTasksCapability — Capability for server tasks 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 - … - `authentication` MCPServerAuthenticationRequirement — Authentication requirements for a remote transport (SEP-2127). - … - `requires` ClientCapabilities — Capabilities a client may support. - `experimental` object, nullable - `sampling` SamplingCapability — Sampling capability structure, allowing fine-grained capability advertisement. - … - `elicitation` ElicitationCapability — Capability for elicitation operations. Clients must support at least one mode (form or url). - … - `roots` RootsCapability — Capability for root operations. - … - `tasks` ClientTasksCapability — Capability for client tasks operations. - … - `resources` union - 'dynamic' - MCPResource[] - … - `tools` union - 'dynamic' - MCPServerCardTool[] - … - `prompts` union - 'dynamic' - MCPPrompt[] - … - `_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 - … - `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' - `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 - `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 - … - `skip_confirmation` union - … - `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 - `active` boolean, 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 - `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 - … - `tool_execution_data` PublicConnectorExecutionData, required - `integrations` PublicExecutionConnector[], required - … - `tools` ExecutionTool[], required - … - `use_connectors_gateway` boolean - `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. - `experimental` object, nullable - `logging` LoggingCapability — Capability for logging operations. - `prompts` PromptsCapability — Capability for prompts operations. - … - `resources` ResourcesCapability — Capability for resources operations. - … - `tools` ToolsCapability — Capability for tools operations. - … - `completions` CompletionsCapability — Capability for completions operations. - `tasks` ServerTasksCapability — Capability for server tasks 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 - … - `authentication` MCPServerAuthenticationRequirement — Authentication requirements for a remote transport (SEP-2127). - … - `requires` ClientCapabilities — Capabilities a client may support. - `experimental` object, nullable - `sampling` SamplingCapability — Sampling capability structure, allowing fine-grained capability advertisement. - … - `elicitation` ElicitationCapability — Capability for elicitation operations. Clients must support at least one mode (form or url). - … - `roots` RootsCapability — Capability for root operations. - … - `tasks` ClientTasksCapability — Capability for client tasks operations. - … - `resources` union - 'dynamic' - MCPResource[] - … - `tools` union - 'dynamic' - MCPServerCardTool[] - … - `prompts` union - 'dynamic' - MCPPrompt[] - … - `_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 - … - `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' - `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 - `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 - … - `skip_confirmation` union - … - `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 - `active` boolean, 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 - `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 - … - `tool_execution_data` PublicConnectorExecutionData, required - `integrations` PublicExecutionConnector[], required - … - `tools` ExecutionTool[], required - … - `use_connectors_gateway` boolean - `errors` string[], required - `protocol` 'http', required - `pagination` PaginationResponse, required - `next_cursor` string, nullable - `page_size` integer, required ## Other responses - `422` — Validation Error ## Changes - **2026-09-23** `fa73befe1c61` — 10 breaking, 19 warning, 1 info - added `#/components/schemas/MCPConnector, #/components/schemas/HTTPConnector` to the `items/items/` response property `oneOf` list for the response status `200` - the `items/items/` response's property type changed from `object` to no type for status `200` - removed the required property `items/items/created_at` from the response with the `200` status - removed the required property `items/items/description` from the response with the `200` status - …26 more - **2026-08-14** `61436a496404` — 1 breaking, 4 warning, 6 info - the `items/items/owner_type` response's property type changed from `integer` to `string` for status `200` - added the new `org` enum value to the `items/items/owner_type` response property for the response status `200` - added the new `system` enum value to the `items/items/owner_type` response property for the response status `200` - added the new `user` enum value to the `items/items/owner_type` response property for the response status `200` - …7 more - …earlier changes not shown [Full history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/connectors/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/fa73befe1c61?raw)