The MindBridge Python SDK implements the official Python API client library published on PyPI as mindbridge-api-python-client. Install the package using pip:

pip install mindbridge-api-python-client

For reliable environment management and to avoid dependency conflicts, use a Python virtual environment. You may use the standard library’s venv module or a third-party tool such as uv.

Authenticate and connect

Generate an API token within your MindBridge tenant by following Create an API token. MindBridge recommends securely managing your API credentials. In these examples, environment variables are used:

MINDBRIDGE_API_URL: The full MindBridge tenant URL (for example, [subdomain].mindbridge.ai)
MINDBRIDGE_API_TOKEN: The API token generated for your account

The following example connects to your MindBridge tenant and retrieves the authenticated user’s profile by calling the /v1/users/current endpoint:

import os
import mindbridgeapi as mbapi

url = os.environ.get("MINDBRIDGE_API_URL", "")
token = os.environ.get("MINDBRIDGE_API_TOKEN", "")

server = mbapi.Server(url=url, token=token)

user = server.users.get_current()
print(f"Name: {user.first_name} {user.last_name}")
print(f"Role: {user.role}")
print(f"ID:   {user.id}")

​Authenticate and connect

Authenticate and connect