Beta Connectors Endpoints

(beta) Connectors

List all connectors.

GET /v1/connectors

List all your custom connectors with keyset pagination and filters.

200

Successful Response

items

*array<Connector>

pagination

*PaginationResponse

Playground

Test the endpoints live

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

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

Create a new connector.

POST /v1/connectors

Create a new MCP connector. You can customize its visibility, url and auth type.

201

Successful Response

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

Test the endpoints live

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)

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

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

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

Get the auth URL for a connector.

GET /v1/connectors/{connector_id_or_name}/auth_url

Get the OAuth2 authorization URL for a connector to initiate user authentication.

200

Successful Response

auth_url

*string

ttl

*integer

Playground

Test the endpoints live

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

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
}

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

Call Connector Tool

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

Call a tool on an MCP connector.

200

Successful Response

AdditionalProperties

map<any>

content

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

metadata

MCPToolCallMetadata|null

Metadata wrapper for MCP tool call responses.

Nests MCP-specific fields under mcp_meta to avoid collisions with other metadata keys (e.g. tool_call_result) in Harmattan's streaming deltas.

Playground

Test the endpoints live

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)

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

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

{
  "content": [
    {
      "text": "ipsum eiusmod",
      "type": "consequat do"
    }
  ]
}

List tools for a connector.

GET /v1/connectors/{connector_id_or_name}/tools

List all tools available for an MCP connector.

200

Response Type

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

Successful Response

integrationsschemasapitoolTool

{object}

MCPTool

{object}

Playground

Test the endpoints live

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

Get authentication methods for a connector.

GET /v1/connectors/{connector_id_or_name}/authentication_methods

Get the authentication schema for a connector. Returns the list of supported authentication methods and their required headers.

200

Response Type

array<PublicAuthenticationMethod>

Successful Response

PublicAuthenticationMethod

{object}

Playground

Test the endpoints live

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

[
  {
    "method_type": "oauth2"
  }
]

[
  {
    "method_type": "oauth2"
  }
]

List organization credentials for a connector.

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

List all credentials configured at the organization level for a given connector.

200

Successful Response

connector_preset_credentials_for_auth

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

credentials

*array<AuthenticationConfiguration>

Playground

Test the endpoints live

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": [
    {
      "authentication_type": "oauth2",
      "name": "ipsum eiusmod"
    }
  ]
}

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

Create or update organization credentials for a connector.

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

Create or update credentials at the organization level for a given connector.

200

Successful Response

message

*string

Playground

Test the endpoints live

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

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

{
  "message": "ipsum eiusmod"
}

List workspace credentials for a connector.

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

List all credentials configured at the workspace level for a given connector.

200

Successful Response

connector_preset_credentials_for_auth

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

credentials

*array<AuthenticationConfiguration>

Playground

Test the endpoints live

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": [
    {
      "authentication_type": "oauth2",
      "name": "ipsum eiusmod"
    }
  ]
}

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

Create or update workspace credentials for a connector.

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

Create or update credentials at the workspace level for a given connector.

200

Successful Response

message

*string

Playground

Test the endpoints live

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

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

{
  "message": "ipsum eiusmod"
}

List user credentials for a connector.

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

List all credentials configured at the user level for a given connector.

200

Successful Response

connector_preset_credentials_for_auth

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

credentials

*array<AuthenticationConfiguration>

Playground

Test the endpoints live

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": [
    {
      "authentication_type": "oauth2",
      "name": "ipsum eiusmod"
    }
  ]
}

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

Create or update user credentials for a connector.

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

Create or update credentials at the user level for a given connector.

200

Successful Response

message

*string

Playground

Test the endpoints live

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

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

{
  "message": "ipsum eiusmod"
}

Delete organization credentials for a connector.

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

Delete credentials at the organization level for a given connector.

200

Successful Response

message

*string

Playground

Test the endpoints live

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

{
  "message": "ipsum eiusmod"
}

Delete workspace credentials for a connector.

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

Delete credentials at the workspace level for a given connector.

200

Successful Response

message

*string

Playground

Test the endpoints live

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

{
  "message": "ipsum eiusmod"
}

Delete user credentials for a connector.

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

Delete credentials at the user level for a given connector.

200

Successful Response

message

*string

Playground

Test the endpoints live

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

{
  "message": "ipsum eiusmod"
}

Get a connector.

GET /v1/connectors/{connector_id_or_name}#idOrName

Get a connector by its ID or name.

200

Successful Response

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

Test the endpoints live

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)

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'

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

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

Delete a connector.

DELETE /v1/connectors/{connector_id}#id

Delete a connector by its ID.

200

Successful Response

message

*string

Playground

Test the endpoints live

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

{
  "message": "ipsum eiusmod"
}

Update a connector.

PATCH /v1/connectors/{connector_id}#id

Update a connector by its ID.

200

Successful Response

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

Test the endpoints live

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

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

Beta Connectors Endpoints

Examples

GET /v1/connectors

Parameters

query_filters

cursor

page_size

items

pagination

Playground

POST /v1/connectors

Request Body

auth_data

description

headers

icon_url

name

server

system_prompt

visibility

auth_type

created_at

description

id

modified_at

name

server

tools

Playground

GET /v1/connectors/{connector_id_or_name}/auth_url

Parameters

app_return_url

credentials_name

connector_id_or_name

auth_url

ttl

Playground

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

Parameters

tool_name

credentials_name

connector_id_or_name

Request Body

arguments

AdditionalProperties

content

metadata

Playground

GET /v1/connectors/{connector_id_or_name}/tools

integrations__schemas__api__tool__Tool

MCPTool

Playground

GET /v1/connectors/{connector_id_or_name}/authentication_methods

Parameters

connector_id_or_name

PublicAuthenticationMethod

Playground

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

Parameters

auth_type

fetch_default

connector_id_or_name

connector_preset_credentials_for_auth

credentials

Playground

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

Parameters

connector_id_or_name

Request Body

credentials

is_default

name

message

Playground

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

Parameters

auth_type

fetch_default

connector_id_or_name

connector_preset_credentials_for_auth

integrationsschemasapitoolTool