Python SDK reference
Applies to: crittora-sdk-python
Primary runtime: Python 3.10+
Last updated: March 8, 2026
This page summarizes the public Python SDK surface for the Direct API: sync and async clients, auth providers, typed request and response models, and the main error classes.
SDK surface
| API | Purpose | Use when |
|---|---|---|
| CrittoraClient | Primary sync client for new Python integrations | You want explicit credentials, auth composition, and typed models |
| AsyncCrittoraClient | Async client with the same request and response surface | Your service stack is async-first and you want parity with the sync API |
| BearerTokenAuth / CognitoAuthProvider | Auth providers for externally managed tokens or SDK-managed login | You need either bearer-token injection or built-in Cognito login |
What the SDK covers
- encrypt and decrypt for confidentiality-only workflows.
- sign_encrypt and decrypt_verify for confidentiality plus authenticity workflows.
- Typed auth, retry, timeout, and exception handling for backend services.
Recommended reading
- Python SDK quickstart for install, auth, and first request examples.
- Authentication models for bearer-token versus Cognito login guidance.
- The SDK repository docs for deeper API, auth, and migration details.