Wandelbots API Client

26.3.0 verified Fri May 01 auth: no python

Official Python client for the Wandelbots NOVA platform, enabling interaction with industrial robots via a modern API. Current version 26.3.0, requires Python >=3.9. Active development with frequent releases.

pip install wandelbots-api-client

Common errors

error ModuleNotFoundError: No module named 'wandelbots' ↓

cause Incorrect import path; the package is 'wandelbots-api-client' but the import is 'wandelbots_api_client'.

fix

Install the package: pip install wandelbots-api-client and use from wandelbots_api_client import ...

error wandelbots_api_client.exceptions.ApiException: (401) Unauthorized ↓

cause Missing or invalid token.

fix

Set the NOVA_TOKEN environment variable or pass a valid token to WandelbotsApiClient.

error TypeError: __init__() got an unexpected keyword argument 'api_key' ↓

cause Old initialization pattern used 'api_key'; new version uses 'token'.

fix

Replace WandelbotsApiClient(api_key=...) with WandelbotsApiClient(token=...).

Warnings

breaking In v26.x, the client configuration moved to a single `WandelbotsApiClient` class with `base_url` and `token` parameters. Previous versions used separate configuration classes. ↓

fix Replace old config patterns with `WandelbotsApiClient(base_url=..., token=...)`.

deprecated The `get_robot_poses` method is deprecated; use `get_current_pose` instead. ↓

fix Replace calls to `client.get_robot_poses(robot_id)` with `client.robots.get_current_pose(robot_id)`.

gotcha Token authentication is required for all API calls. If the token is invalid or missing, the client may throw an unclear error. ↓

fix Ensure `NOVA_TOKEN` environment variable is set or pass a valid token.

Imports

WandelbotsApiClient

wrong

from wandelbots import ApiClient

correct

from wandelbots_api_client import WandelbotsApiClient

Wrong module name

models

wrong

from wandelbots_api_client.models import *

correct

from wandelbots_api_client import models

Avoid star imports; specific imports are clearer

Quickstart

Initialize client and perform health check.

import os
from wandelbots_api_client import WandelbotsApiClient
from wandelbots_api_client import models

client = WandelbotsApiClient(
    base_url=os.environ.get('NOVA_BASE_URL', 'https://your-instance.nova.wandelbots.io'),
    token=os.environ.get('NOVA_TOKEN', '')
)
print(client.api_health_check())