2.20.1

📦 CTERA Python SDK – Release Notes

🚀 New Features & Enhancements

• Bearer Token Support
  Support initialization of the CTERA Direct IO client using a Bearer token for flexible authentication options.

• Improved Path Handling
  Clients can now use both relative and absolute paths. Previously, paths starting with / were not allowed — this limitation has been removed!

• Async Team Portal Browsing
  The AsyncGlobalAdmin object now supports browsing Team Portals.

• Team Portal Impersonation API
  Added support for instantiating a Team Portal user session from an admin session using the Impersonation API, available via GlobalAdmin and AsyncGlobalAdmin.

• File Handle Support
  New ability to:

  • Obtain a handle for an individual file
  • Generate a handle for a ZIP archive containing multiple files

• Upload from File Handle
  Support for uploading files directly from a file-like object (handle).

• Asynchronous File Operations (asyncio)
  Async support for file operations enables easier implementation of a CTERA Portal MCP Server. Supported methods include:

  • handle, handle_many, upload, upload_file, mkdir, makedirs, listdir, walk
  • versions, rename, delete, undelete, copy, move, permalink

• Refactored File Access Library
  Common infrastructure for sync and async file operations to reduce duplication and improve maintainability.

• Improved Unit Testing Infrastructure

  • Shared infrastructure to patch calls for testing
  • Added unit tests for:
    • Retrieving versions
    • mkdir
    • File browser functionality

• New File Access Exceptions
  Introduced new exception classes for granular error handling during file operations.

---

🧾 Documentation Updates

• Fixed documentation for CTERA Direct IO client initialization
• Added new documentation for managing Edge Filer storage arrays

2.19.59

parity implementation of asynchronous iterators with user defined schema methods

2.19.58

feat: add new role settings with test support

Added new role settings to RoleSettings class:

• allowFoldersFilesPermanentDelete: Control permanent file/folder deletion
• canManageLegalHolds: Control legal hold management permissions
• canManageComplianceSetting: Control compliance settings management

Updated corresponding test cases to include the new settings.

2.19.57

update task manager for edge and core (#289)

2.19.56

Refactor unit-tests, update set_timezone in Portal documentation

2.19.55

Resolve issues accessing agents from the Portal
Support permalink

2.19.54

Saimon/add docs file access (#285)

2.19.53

Saimon/include postman when enabled (#284)

2.19.52

Support exporting the SDK calls into a Postman collection

2.19.51

fix docs