La spec OpenAPI
Home
Public Preview
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.list({});

  console.log(result);
}

run();

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-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": "user",
      "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
connection_config#
PublicConnectionConfig|null
connection_credentials#
array<AuthenticationConfiguration>|null
connection_preferences#
array<ConnectionPreference>|null
created_at#
*date-time
creator_id#
string|null
description#
*string
execution_env#
PublicExecutionEnv|null

Projection sans identifiants de ExecutionEnv pour la réponse publique /connectors/mistral.

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#
*"user"|"org"|"workspace"|"system"
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 { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.create({
    name: "<value>",
    description: "unibody usually despite slushy wherever reward stingy from",
    server: "https://royal-majority.net/",
  });

  console.log(result);
}

run();

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": "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": "user",
  "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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.getAuthUrl({
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.get_auth_url(connector_id_or_name="<value>", github_installation_link=False)

    # Handle response
    print(res)


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

200

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

Partager un connecteur privé avec l'espace de travail actuel.

PUT /v1/connectors/{connector_id}/share#

Transfère la propriété d'un connecteur privé détenu par un utilisateur vers l'espace de travail actuel, le rendant disponible à tous les membres de l'espace de travail. Le créateur peut ultérieurement annuler cette action via le point de terminaison de non-partage. Tout flux d'authentification reposant sur l'identité du propriétaire d'origine (par exemple, OAuth on-behalf-of) sera affecté et devra être reconfiguré après le partage. Seul le créateur du connecteur peut appeler ce point de terminaison. Nécessite l'autorisation d'espace de travail ShareConnectorToWorkspace.

200

Réponse réussie

message#
*string

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.share({
    connectorId: "cf748b50-632b-46d6-98c3-b015086cb194",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.share(connector_id="cf748b50-632b-46d6-98c3-b015086cb194")

    # Handle response
    print(res)


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

200

{
  "message": "Example message."
}

Ne plus partager un connecteur avec l'espace de travail actuel.

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

Rétablit un connecteur partagé dans un espace de travail en un connecteur privé, détenu par son créateur. Les connexions à portée d'espace de travail et les connexions des autres membres sont supprimées ; la connexion propre du créateur est préservée. Seul le créateur du connecteur peut appeler ce point de terminaison. Nécessite l'autorisation d'espace de travail ShareConnectorToWorkspace.

200

Réponse réussie

message#
*string

Playground

Testez les endpoints en direct

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

200

{
  "message": "Example message."
}

Activer un connecteur pour le consommateur donné (organisation, espace de travail, utilisateur).

POST /v1/connectors/{connector_id}/{consumer_scope}/activate#

Activer un connecteur pour le consommateur.

200

Réponse réussie

message#
*string

Playground

Testez les endpoints en direct

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

200

{
  "message": "Example message."
}

Désactiver un connecteur pour le consommateur actuel (au niveau organisation, espace de travail ou utilisateur).

POST /v1/connectors/{connector_id}/{consumer_scope}/deactivate#

Désactiver un connecteur uniquement pour le consommateur appelant.

200

Réponse réussie

message#
*string

Playground

Testez les endpoints en direct

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

200

{
  "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 { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.callTool({
    toolName: "<value>",
    connectorIdOrName: "<value>",
    connectorCallToolRequest: {},
  });

  console.log(result);
}

run();

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": "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<MCPTool>|array<map<any>>

Réponse réussie

MCPTool#

{object}

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.listTools({
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.list_tools(connector_id_or_name="<value>", page=1, page_size=100, refresh=False, pretty=False)

    # Handle response
    print(res)


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

200

[
  {
    "inputSchema": [
      null
    ],
    "name": "My resource"
  }
]

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.getAuthenticationMethods({
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.get_authentication_methods(connector_id_or_name="<value>")

    # Handle response
    print(res)


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

200

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.listOrganizationCredentials({
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.list_organization_credentials(connector_id_or_name="<value>", fetch_default=False)

    # Handle response
    print(res)


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

200

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.createOrUpdateOrganizationCredentials({
    connectorIdOrName: "<value>",
    credentialsCreateOrUpdate: {
      name: "<value>",
    },
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.create_or_update_organization_credentials(connector_id_or_name="<value>", name="<value>")

    # Handle response
    print(res)


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."
}

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.listWorkspaceCredentials({
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.list_workspace_credentials(connector_id_or_name="<value>", fetch_default=False)

    # Handle response
    print(res)


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

200

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.createOrUpdateWorkspaceCredentials({
    connectorIdOrName: "<value>",
    credentialsCreateOrUpdate: {
      name: "<value>",
    },
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.create_or_update_workspace_credentials(connector_id_or_name="<value>", name="<value>")

    # Handle response
    print(res)


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."
}

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.listUserCredentials({
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.list_user_credentials(connector_id_or_name="<value>", fetch_default=False)

    # Handle response
    print(res)


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

200

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.createOrUpdateUserCredentials({
    connectorIdOrName: "<value>",
    credentialsCreateOrUpdate: {
      name: "<value>",
    },
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.create_or_update_user_credentials(connector_id_or_name="<value>", name="<value>")

    # Handle response
    print(res)


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."
}

Supprimer toutes les informations d'identification utilisateur pour un connecteur.

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

Supprimer toutes les informations d'identification configurées 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 DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.deleteOrganizationCredentials({
    credentialsName: "<value>",
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.delete_organization_credentials(credentials_name="<value>", connector_id_or_name="<value>")

    # Handle response
    print(res)


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."
}

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.deleteWorkspaceCredentials({
    credentialsName: "<value>",
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.delete_workspace_credentials(credentials_name="<value>", connector_id_or_name="<value>")

    # Handle response
    print(res)


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."
}

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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.deleteUserCredentials({
    credentialsName: "<value>",
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


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

    res = mistral.beta.connectors.delete_user_credentials(credentials_name="<value>", connector_id_or_name="<value>")

    # Handle response
    print(res)


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."
}

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
creator_id#
string|null
description#
*string
execution_env#
PublicExecutionEnv|null

Projection sans identifiants de ExecutionEnv pour la réponse publique /connectors/mistral.

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#
*"user"|"org"|"workspace"|"system"
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 { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.get({
    connectorIdOrName: "<value>",
  });

  console.log(result);
}

run();

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_user_data=False, fetch_customer_data=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-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": "user",
  "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

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.delete({
    connectorId: "5c3269fe-6a18-4216-b1fb-b093005874cd",
  });

  console.log(result);
}

run();

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": "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
creator_id#
string|null
description#
*string
execution_env#
PublicExecutionEnv|null

Projection sans identifiants de ExecutionEnv pour la réponse publique /connectors/mistral.

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#
*"user"|"org"|"workspace"|"system"
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 { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.connectors.update({
    connectorId: "81d30634-113f-4dce-a89e-7786be2d8693",
    updateConnectorRequest: {},
  });

  console.log(result);
}

run();

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-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": "user",
  "private_tool_execution": false,
  "visibility": "shared_global"
}