La spec OpenAPI
Home
Beta
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Endpoints des connecteurs Beta

(Beta) Connecteurs

Lister tous les connecteurs.

GET /v1/connectors

Liste 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)


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

200

{
  "items": [
    {
      "created_at": "2025-10-07T20:56:01.974Z",
      "description": "ipsum eiusmod",
      "id": "consequat do",
      "modified_at": "2025-10-07T20:56:01.974Z",
      "name": "reprehenderit ut dolore"
    }
  ],
  "pagination": {
    "page_size": 87
  }
}

Créer un nouveau connecteur.

POST /v1/connectors

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

201

Réponse réussie

auth_type
string|null
created_at
*date-time
description
*string
id
*string
modified_at
*date-time
name
*string
server
string|null
tools
array<integrations__schemas__api__tool__Tool>|null

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.create(name="<value>", description="unibody usually despite slushy wherever reward stingy from", server="https://royal-majority.net/")

    # Handle response
    print(res)


curl https://api.mistral.ai/v1/connectors \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "description": "ipsum eiusmod",
  "name": "consequat do",
  "server": "reprehenderit ut dolore"
}'

201

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "modified_at": "2025-10-07T20:56:01.974Z",
  "name": "reprehenderit ut dolore"
}

Récupérer l’URL d’authentification d’un connecteur.

GET /v1/connectors/{connector_id_or_name}/auth_url #{operation-connector_get_auth_url_v1}

Récupère l’URL OAuth2 d’autorisation d’un connecteur pour 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/{connector_id_or_name}/auth_url \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "auth_url": "ipsum eiusmod",
  "ttl": 87
}

Appeler un outil de connecteur

POST /v1/connectors/{connector_id_or_name}/tools/{tool_name}/call #{operation-connector_call_tool_v1}

Appelle un outil sur un connecteur MCP.

200

Réponse réussie

AdditionalProperties
map<any>
content
*array<TextContent|ImageContent|AudioContent|ResourceLink|EmbeddedResource>
metadata
MCPToolCallMetadata|null

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

Les champs spécifiques à MCP sont imbriqués sous mcp_meta pour éviter les conflits 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

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.call_tool(tool_name="<value>", connector_id_or_name="<value>")

    # Handle response
    print(res)


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": "ipsum eiusmod",
      "type": "consequat do"
    }
  ]
}

Lister les outils pour un connecteur.

GET /v1/connectors/{connector_id_or_name}/tools

Liste tous les outils disponibles pour un Connecteur MCP.

200

Response Type
array<integrations__schemas__api__tool__Tool>|null|array<MCPTool>|array<map<any>>

Réponse réussie

integrations__schemas__api__tool__Tool

{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'

200

null

Récupérer les méthodes d’authentification pour un connecteur.

GET /v1/connectors/{connector_id_or_name}/authentication_methods

Récupérer 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>

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'

200

[
  {
    "method_type": "oauth2"
  }
]

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

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

Liste 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">
credentials
*array<AuthenticationConfiguration>

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'

200

{
  "credentials": [
    {
      "authentication_type": "oauth2",
      "name": "ipsum eiusmod"
    }
  ]
}

Créer ou mettre à jour les identifiants d'organisation pour un connecteur.

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

Crée ou met à jour les identifiants 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": "ipsum eiusmod"
}'

200

{
  "message": "ipsum eiusmod"
}

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

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

Liste tous les identifiants configurés 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">
credentials
*array<AuthenticationConfiguration>

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'

200

{
  "credentials": [
    {
      "authentication_type": "oauth2",
      "name": "ipsum eiusmod"
    }
  ]
}

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

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

Crée ou met à jour les 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": "ipsum eiusmod"
}'

200

{
  "message": "ipsum eiusmod"
}

Lister les identifiants utilisateur pour un connecteur.

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

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

200

Réponse réussie

connector_preset_credentials_for_auth
array<"oauth2"|"bearer"|"none">
credentials
*array<AuthenticationConfiguration>

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'

200

{
  "credentials": [
    {
      "authentication_type": "oauth2",
      "name": "ipsum eiusmod"
    }
  ]
}

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

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

Créer ou mettre à jour les informations d'identification au niveau 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": "ipsum eiusmod"
}'

200

{
  "message": "ipsum eiusmod"
}

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'

200

{
  "message": "ipsum eiusmod"
}

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

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

Supprimer les informations d'identification 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'

200

{
  "message": "ipsum eiusmod"
}

Supprimer les informations d'identification utilisateur pour un connecteur.

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

Supprimer les informations d'identification au niveau 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'

200

{
  "message": "ipsum eiusmod"
}

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

auth_type
string|null
created_at
*date-time
description
*string
id
*string
modified_at
*date-time
name
*string
server
string|null
tools
array<integrations__schemas__api__tool__Tool>|null

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.get(connector_id_or_name="<value>", fetch_customer_data=False, fetch_connection_secrets=False)

    # Handle response
    print(res)


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

200

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "modified_at": "2025-10-07T20:56:01.974Z",
  "name": "reprehenderit ut dolore"
}

Supprimer un connecteur.

DELETE /v1/connectors/{connector_id}#{id}

Supprime un connecteur via 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)


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": "ipsum eiusmod"
}

Mettre à jour un connecteur.

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

Met à jour un connecteur via son ID.

200

Réponse réussie

auth_type
string|null
created_at
*date-time
description
*string
id
*string
modified_at
*date-time
name
*string
server
string|null
tools
array<integrations__schemas__api__tool__Tool>|null

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)


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-10-07T20:56:01.974Z",
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "modified_at": "2025-10-07T20:56:01.974Z",
  "name": "reprehenderit ut dolore"
}