ucotron-sdk 1.0.0

Official Ucotron API client SDK for Python — auto-generated from OpenAPI.

ucotron-sdk

Official Python 3.9+ client for the Ucotron Core API.

Full quickstart, 5 use-case walkthroughs, and reference docs: https://docs.ucotron.com/sdks/python

Install

pip install ucotron-sdk
# or
uv add ucotron-sdk

Usage

import os
from ucotron_sdk import UcotronClient

ucotron = UcotronClient(api_key=os.environ["UCOTRON_API_KEY"])

# List plans
plans = ucotron.plans.list(limit=20)

# Generate a plan
plan = ucotron.plans.generate(interaction_id="int_123")

# Verify an incoming webhook signature
ok = UcotronClient.verify_webhook_signature(
    body=raw_body,                                     # bytes
    signature=request.headers["X-Ucotron-Signature"],  # str
    secret=os.environ["WEBHOOK_SECRET"],
)

Versioning

This package follows the API revision in openapi.yaml (info.version). A minor API bump triggers a minor SDK bump. PEP-440 pre-release tags (1.0.0a0) map to the semver alpha tags.

License

Apache-2.0.