--- 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. - `cursor` string, nullable - `page_size` integer ## Response `200` Successful Response - PaginatedConnectors - `items` Connector[], required - `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. - … - `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. - … - `elicitation` TasksElicitationCapability — Capability for tasks 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. - … - `ai.mistral/turbine` TurbineToolMeta - … - `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` 1 | 2 | 3 | 4, 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 - `has_default_credentials` boolean, required - `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' | '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 - … - `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 - `pagination` PaginationResponse, required - `next_cursor` string, nullable - `page_size` integer, 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/versions/933c4ebdcd72/schema)