Connecteurs bêta

API Connectors (bêta) - gérer vos connecteurs

Lister tous les connecteurs.

GET /v1/connectors

Lister tous vos connecteurs personnalisés avec une pagination par clés et des filtres.

200

Réponse réussie

items

*array<Connector>

pagination

*PaginationResponse

Playground

Testez les endpoints en direct

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.list(page_size=100)

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.list(page_size=100)

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/connectors \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "items": [
    {
      "created_at": "2025-12-17T10:25:07.818693Z",
      "description": "My resource description.",
      "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
      "modified_at": "2025-12-17T10:41:03.469341Z",
      "name": "My resource",
      "owner_type": "1",
      "private_tool_execution": false,
      "visibility": "shared_global"
    }
  ],
  "pagination": {
    "page_size": "1000"
  }
}

{
  "items": [
    {
      "created_at": "2025-12-17T10:25:07.818693Z",
      "description": "My resource description.",
      "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
      "modified_at": "2025-12-17T10:41:03.469341Z",
      "name": "My resource",
      "owner_type": "1",
      "private_tool_execution": false,
      "visibility": "shared_global"
    }
  ],
  "pagination": {
    "page_size": "1000"
  }
}

Créer un nouveau connecteur.

POST /v1/connectors

Créer un nouveau connecteur MCP. Vous pouvez personnaliser sa visibilité, son URL et son type d'authentification.

201

Réponse réussie

active

boolean|null

created_at

*date-time

description

*string

icon_url

string|null

id

*string

is_authenticated

boolean|null

locale

ConnectorLocale|null

mistral

boolean

Default Value: false

modified_at

*date-time

name

*string

owner_id

string|null

owner_type

*"1"|"2"|"3"|"4"

private_tool_execution

*boolean

protocol

"mcp"|"http"|"turbine"

server

string|null

server_card

MCPServerCard|null

supported_auth_methods

array<PublicAuthenticationMethod>|null

system_prompt

string|null

system_prompt_route

string|null

title

string|null

tools

array<ConnectorTool>|null

visibility

*"shared_global"|"shared_org"|"shared_workspace"|"private"

Playground

Testez les endpoints en direct

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

connector = client.beta.connectors.create(
    name="company_docs",
    description="Company documentation MCP connector",
    server="https://mcp.example.com",
)

print(connector.id)

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

connector = client.beta.connectors.create(
    name="company_docs",
    description="Company documentation MCP connector",
    server="https://mcp.example.com",
)

print(connector.id)

curl https://api.mistral.ai/v1/connectors \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "description": "My resource description.",
  "name": "My resource",
  "server": "https://mcp.example.com"
}'

curl https://api.mistral.ai/v1/connectors \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "description": "My resource description.",
  "name": "My resource",
  "server": "https://mcp.example.com"
}'

201

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "description": "My resource description.",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "modified_at": "2025-12-17T10:41:03.469341Z",
  "name": "My resource",
  "owner_type": "1",
  "private_tool_execution": false,
  "visibility": "shared_global"
}

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "description": "My resource description.",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "modified_at": "2025-12-17T10:41:03.469341Z",
  "name": "My resource",
  "owner_type": "1",
  "private_tool_execution": false,
  "visibility": "shared_global"
}

Obtenir l'URL d'authentification pour un connecteur.

GET /v1/connectors/{connector_id_or_name}/auth_url

Obtenir l'URL d'autorisation OAuth2 pour un connecteur afin d'initier l'authentification de l'utilisateur.

200

Réponse réussie

auth_url

*string

ttl

*integer

Playground

Testez les endpoints en direct

curl "https://api.mistral.ai/v1/connectors/company_docs/auth_url?credentials_name=production" \
  -H "Authorization: Bearer $MISTRAL_API_KEY"

curl "https://api.mistral.ai/v1/connectors/company_docs/auth_url?credentials_name=production" \
  -H "Authorization: Bearer $MISTRAL_API_KEY"

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

auth_url = client.beta.connectors.get_auth_url(
    connector_id_or_name="company_docs",
    credentials_name="production",
)

print(auth_url.auth_url)

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

auth_url = client.beta.connectors.get_auth_url(
    connector_id_or_name="company_docs",
    credentials_name="production",
)

print(auth_url.auth_url)

200

{
  "auth_url": "https://auth.example.com/oauth/authorize",
  "ttl": 87
}

{
  "auth_url": "https://auth.example.com/oauth/authorize",
  "ttl": 87
}

Activer un connecteur pour une organisation.

POST /v1/connectors/{connector_id}/organization/activate

Activer un connecteur au niveau de l'organisation afin que tous les membres puissent l'utiliser.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/019b2bd7-96e7-7219-8c0b-45a73da50088/organization/activate \
  -X POST \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include": ["search"],
    "requires_confirmation": ["delete_document"],
    "skip_confirmation": ["read_document"]
  }'

curl https://api.mistral.ai/v1/connectors/019b2bd7-96e7-7219-8c0b-45a73da50088/organization/activate \
  -X POST \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include": ["search"],
    "requires_confirmation": ["delete_document"],
    "skip_confirmation": ["read_document"]
  }'

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.beta.connectors.activate_for_organization(
    connector_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
    tool_configuration={
        "include": ["search"],
        "requires_confirmation": ["delete_document"],
        "skip_confirmation": ["read_document"],
    },
)

print(response.message)

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.beta.connectors.activate_for_organization(
    connector_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
    tool_configuration={
        "include": ["search"],
        "requires_confirmation": ["delete_document"],
        "skip_confirmation": ["read_document"],
    },
)

print(response.message)

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Désactiver un connecteur pour une organisation.

POST /v1/connectors/{connector_id}/organization/deactivate

Désactiver un connecteur au niveau de l'organisation.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id}/organization/deactivate \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/connectors/{connector_id}/organization/deactivate \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Activer un connecteur pour un espace de travail.

POST /v1/connectors/{connector_id}/workspace/activate

Activer un connecteur au niveau de l'espace de travail afin que tous les membres de l'espace de travail puissent l'utiliser.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/019b2bd7-96e7-7219-8c0b-45a73da50088/workspace/activate \
  -X POST \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include": ["search"],
    "requires_confirmation": ["delete_document"],
    "skip_confirmation": ["read_document"]
  }'

curl https://api.mistral.ai/v1/connectors/019b2bd7-96e7-7219-8c0b-45a73da50088/workspace/activate \
  -X POST \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include": ["search"],
    "requires_confirmation": ["delete_document"],
    "skip_confirmation": ["read_document"]
  }'

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.beta.connectors.activate_for_workspace(
    connector_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
    tool_configuration={
        "include": ["search"],
        "requires_confirmation": ["delete_document"],
        "skip_confirmation": ["read_document"],
    },
)

print(response.message)

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.beta.connectors.activate_for_workspace(
    connector_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
    tool_configuration={
        "include": ["search"],
        "requires_confirmation": ["delete_document"],
        "skip_confirmation": ["read_document"],
    },
)

print(response.message)

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Désactiver un connecteur pour un espace de travail.

POST /v1/connectors/{connector_id}/workspace/deactivate

Désactiver un connecteur au niveau de l'espace de travail.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id}/workspace/deactivate \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/connectors/{connector_id}/workspace/deactivate \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Activer un connecteur pour l'utilisateur actuel.

POST /v1/connectors/{connector_id}/user/activate

Activer un connecteur uniquement pour l'utilisateur appelant.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/019b2bd7-96e7-7219-8c0b-45a73da50088/user/activate \
  -X POST \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include": ["search"],
    "requires_confirmation": ["delete_document"],
    "skip_confirmation": ["read_document"]
  }'

curl https://api.mistral.ai/v1/connectors/019b2bd7-96e7-7219-8c0b-45a73da50088/user/activate \
  -X POST \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include": ["search"],
    "requires_confirmation": ["delete_document"],
    "skip_confirmation": ["read_document"]
  }'

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.beta.connectors.activate_for_user(
    connector_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
    tool_configuration={
        "include": ["search"],
        "requires_confirmation": ["delete_document"],
        "skip_confirmation": ["read_document"],
    },
)

print(response.message)

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.beta.connectors.activate_for_user(
    connector_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
    tool_configuration={
        "include": ["search"],
        "requires_confirmation": ["delete_document"],
        "skip_confirmation": ["read_document"],
    },
)

print(response.message)

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Désactiver un connecteur pour l'utilisateur actuel.

POST /v1/connectors/{connector_id}/user/deactivate

Désactiver un connecteur uniquement pour l'utilisateur appelant.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id}/user/deactivate \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/connectors/{connector_id}/user/deactivate \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Appeler un outil de connecteur

POST /v1/connectors/{connector_id_or_name}/tools/{tool_name}/call

Appeler un outil sur un connecteur MCP.

200

Réponse réussie

AdditionalProperties

map<any>

content

*array<TextContent|ImageContent|AudioContent|ResourceLink|EmbeddedResource>

metadata

ConnectorToolCallMetadata|null

Enveloppe de métadonnées pour les réponses d'appel d'outil MCP.

Regroupe les champs spécifiques à MCP sous mcp_meta pour éviter les collisions avec d'autres clés de métadonnées (par exemple, tool_call_result) dans les deltas de streaming de Harmattan.

Playground

Testez les endpoints en direct

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

result = client.beta.connectors.call_tool(
    connector_id_or_name="company_docs",
    tool_name="search",
)

print(result)

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

result = client.beta.connectors.call_tool(
    connector_id_or_name="company_docs",
    tool_name="search",
)

print(result)

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/tools/{tool_name}/call \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/tools/{tool_name}/call \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "content": [
    {
      "text": "Example text.",
      "type": "document"
    }
  ]
}

{
  "content": [
    {
      "text": "Example text.",
      "type": "document"
    }
  ]
}

Lister les outils pour un connecteur.

GET /v1/connectors/{connector_id_or_name}/tools

Lister tous les outils disponibles pour un connecteur MCP.

200

Response Type

array<ConnectorTool>|null|array<MCPTool>|array<map<any>>

Réponse réussie

ConnectorTool

{object}

MCPTool

{object}

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/tools \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/tools \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

null

null

Obtenir les méthodes d'authentification pour un connecteur.

GET /v1/connectors/{connector_id_or_name}/authentication_methods

Obtenir le schéma d'authentification pour un connecteur. Retourne la liste des méthodes d'authentification prises en charge et leurs en-têtes requis.

200

Response Type

array<PublicAuthenticationMethod>|null

Réponse réussie

PublicAuthenticationMethod

{object}

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/authentication_methods \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/authentication_methods \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

null

null

Lister les informations d'identification de l'organisation pour un connecteur.

GET /v1/connectors/{connector_id_or_name}/organization/credentials

Lister toutes les informations d'identification configurées au niveau de l'organisation pour un connecteur donné.

200

Réponse réussie

connector_preset_credentials_for_auth

array<"oauth2"|"bearer"|"none"|"github_app"|"slack_app">

credentials

*array<AuthenticationConfiguration>|null

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/organization/credentials \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/organization/credentials \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "credentials": null
}

{
  "credentials": null
}

Créer ou mettre à jour les informations d'identification de l'organisation pour un connecteur.

POST /v1/connectors/{connector_id_or_name}/organization/credentials

Créer ou mettre à jour des informations d'identification au niveau de l'organisation pour un connecteur donné.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/organization/credentials \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My resource"
}'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/organization/credentials \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My resource"
}'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Lister les identifiants d'espace de travail pour un connecteur.

GET /v1/connectors/{connector_id_or_name}/workspace/credentials

Lister toutes les informations d'identification configurées au niveau de l'espace de travail pour un connecteur donné.

200

Réponse réussie

connector_preset_credentials_for_auth

array<"oauth2"|"bearer"|"none"|"github_app"|"slack_app">

credentials

*array<AuthenticationConfiguration>|null

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/workspace/credentials \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/workspace/credentials \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "credentials": null
}

{
  "credentials": null
}

Créer ou mettre à jour des identifiants d'espace de travail pour un connecteur.

POST /v1/connectors/{connector_id_or_name}/workspace/credentials

Créer ou mettre à jour des identifiants au niveau de l'espace de travail pour un connecteur donné.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/workspace/credentials \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My resource"
}'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/workspace/credentials \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My resource"
}'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Lister les informations d'identification de l'utilisateur pour un connecteur.

GET /v1/connectors/{connector_id_or_name}/user/credentials

Lister toutes les informations d'identification configurées au niveau de l'utilisateur pour un connecteur donné.

200

Réponse réussie

connector_preset_credentials_for_auth

array<"oauth2"|"bearer"|"none"|"github_app"|"slack_app">

credentials

*array<AuthenticationConfiguration>|null

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/user/credentials \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/user/credentials \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "credentials": null
}

{
  "credentials": null
}

Créer ou mettre à jour les informations d'identification de l'utilisateur pour un connecteur.

POST /v1/connectors/{connector_id_or_name}/user/credentials

Créer ou mettre à jour des informations d'identification au niveau de l'utilisateur pour un connecteur donné.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/user/credentials \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My resource"
}'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/user/credentials \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My resource"
}'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Supprimer les informations d'identification de l'organisation pour un connecteur.

DELETE /v1/connectors/{connector_id_or_name}/organization/credentials/{credentials_name}

Supprimer les informations d'identification au niveau de l'organisation pour un connecteur donné.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/organization/credentials/{credentials_name} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/organization/credentials/{credentials_name} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Supprimer des identifiants d'espace de travail pour un connecteur.

DELETE /v1/connectors/{connector_id_or_name}/workspace/credentials/{credentials_name}

Supprimer des identifiants au niveau de l'espace de travail pour un connecteur donné.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/workspace/credentials/{credentials_name} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/workspace/credentials/{credentials_name} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Supprimer les informations d'identification de l'utilisateur pour un connecteur.

DELETE /v1/connectors/{connector_id_or_name}/user/credentials/{credentials_name}

Supprimer les informations d'identification au niveau de l'utilisateur pour un connecteur donné.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/user/credentials/{credentials_name} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/user/credentials/{credentials_name} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Obtenir un connecteur.

GET /v1/connectors/{connector_id_or_name}#idOrName

Obtenir un connecteur par son ID ou son nom.

200

Réponse réussie

active

boolean|null

connection_config

PublicConnectionConfig|null

connection_credentials

array<AuthenticationConfiguration>|null

connection_preferences

array<ConnectionPreference>|null

created_at

*date-time

description

*string

icon_url

string|null

id

*string

is_authenticated

boolean|null

locale

ConnectorLocale|null

mistral

boolean

Default Value: false

modified_at

*date-time

name

*string

owner_id

string|null

owner_type

*"1"|"2"|"3"|"4"

private_tool_execution

*boolean

protocol

"mcp"|"http"|"turbine"

server

string|null

server_card

MCPServerCard|null

supported_auth_methods

array<PublicAuthenticationMethod>|null

system_prompt

string|null

system_prompt_route

string|null

title

string|null

tools

array<ConnectorTool>|null

visibility

*"shared_global"|"shared_org"|"shared_workspace"|"private"

Playground

Testez les endpoints en direct

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

connector = client.beta.connectors.get(
    connector_id_or_name="company_docs",
    fetch_customer_data=False,
    fetch_connection_secrets=False,
)

print(connector.name)

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

connector = client.beta.connectors.get(
    connector_id_or_name="company_docs",
    fetch_customer_data=False,
    fetch_connection_secrets=False,
)

print(connector.name)

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}#idOrName \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}#idOrName \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "description": "My resource description.",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "modified_at": "2025-12-17T10:41:03.469341Z",
  "name": "My resource",
  "owner_type": "1",
  "private_tool_execution": false,
  "visibility": "shared_global"
}

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "description": "My resource description.",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "modified_at": "2025-12-17T10:41:03.469341Z",
  "name": "My resource",
  "owner_type": "1",
  "private_tool_execution": false,
  "visibility": "shared_global"
}

Supprimer un connecteur.

DELETE /v1/connectors/{connector_id}#id

Supprimer un connecteur par son ID.

200

Réponse réussie

message

*string

Playground

Testez les endpoints en direct

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.delete(connector_id="5c3269fe-6a18-4216-b1fb-b093005874cd")

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.delete(connector_id="5c3269fe-6a18-4216-b1fb-b093005874cd")

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/connectors/{connector_id}#id \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/connectors/{connector_id}#id \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "message": "Example message."
}

{
  "message": "Example message."
}

Mettre à jour un connecteur.

PATCH /v1/connectors/{connector_id}#id

Mettre à jour un connecteur par son ID.

200

Réponse réussie

active

boolean|null

connection_config

PublicConnectionConfig|null

connection_credentials

array<AuthenticationConfiguration>|null

connection_preferences

array<ConnectionPreference>|null

created_at

*date-time

description

*string

icon_url

string|null

id

*string

is_authenticated

boolean|null

locale

ConnectorLocale|null

mistral

boolean

Default Value: false

modified_at

*date-time

name

*string

owner_id

string|null

owner_type

*"1"|"2"|"3"|"4"

private_tool_execution

*boolean

protocol

"mcp"|"http"|"turbine"

server

string|null

server_card

MCPServerCard|null

supported_auth_methods

array<PublicAuthenticationMethod>|null

system_prompt

string|null

system_prompt_route

string|null

title

string|null

tools

array<ConnectorTool>|null

visibility

*"shared_global"|"shared_org"|"shared_workspace"|"private"

Playground

Testez les endpoints en direct

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.update(connector_id="81d30634-113f-4dce-a89e-7786be2d8693")

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.update(connector_id="81d30634-113f-4dce-a89e-7786be2d8693")

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/connectors/{connector_id}#id \
 -X PATCH \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

curl https://api.mistral.ai/v1/connectors/{connector_id}#id \
 -X PATCH \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "description": "My resource description.",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "modified_at": "2025-12-17T10:41:03.469341Z",
  "name": "My resource",
  "owner_type": "1",
  "private_tool_execution": false,
  "visibility": "shared_global"
}

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "description": "My resource description.",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "modified_at": "2025-12-17T10:41:03.469341Z",
  "name": "My resource",
  "owner_type": "1",
  "private_tool_execution": false,
  "visibility": "shared_global"
}

Connecteurs bêta

Exemples

GET /v1/connectors

Parameters

query_filters

cursor

page_size

items

pagination

Playground

POST /v1/connectors

Request Body

auth_data

description

headers

icon_url

name

oauth2_server_metadata

oauth2_server_metadata_url

protocol

server

system_prompt

title

visibility

active

connection_config

connection_credentials

connection_preferences

created_at

description

icon_url

id

is_authenticated

locale

mistral

modified_at

name

owner_id

owner_type

private_tool_execution

protocol

server

server_card

supported_auth_methods

system_prompt

system_prompt_route

title

tools

visibility

Playground

GET /v1/connectors/{connector_id_or_name}/auth_url

auth_url

ttl

Playground

POST /v1/connectors/{connector_id}/organization/activate

Parameters

connector_id

Request Body

exclude

include

requires_confirmation

skip_confirmation

message

Playground

POST /v1/connectors/{connector_id}/organization/deactivate

Parameters

connector_id

message

Playground

POST /v1/connectors/{connector_id}/workspace/activate

Parameters

connector_id

Request Body

exclude

include

requires_confirmation

skip_confirmation

message

Playground

POST /v1/connectors/{connector_id}/workspace/deactivate