Improvements and bug fixes.

4.4.38 - August 20, 2025

---

Updated

- ``SAClient.create_project`` now supports template uploads for Multimodal projects with the addition of a new ``form`` parameter.
- ``SAClient.upload_video_to_project`` should install ``ffmpeg-python`` manually for the function.
- ``SAClient.upload_videos_from_folder_to_project`` should install ``ffmpeg-python`` manually for the function.

Improvements and bug fixes.

Added

- ``SAClient.create_categories`` creates one or more categories in a project. 
- ``SAClient.remove_categories`` removes one or more categories in a project.
- ``SAClient.list_categories`` lists all categories in the project.
- ``SAClient.set_contributors_categories`` assigns one or more categories to specified contributors.
- ``SAClient.remove_contributors_categories`` removes specified categories from contributors.
- ``SAClient.set_items_category`` adds categories to one or more items. 
- ``SAClient.remove_items_category`` removes categories from one or more items.

Updated

- ``SAClient.list_users`` now includes an optional ``categories`` value in the ``include`` parameter to return each contributor's assigned categories when a project is specified.

Improvements and bug fixes.

Updated

- ``SAClient.get_project_steps`` and ``SAClient.get_project_steps`` now support keypoint workflows, enabling structured step configuration with class             IDs, attributes, and step connections.
- ``SAClient.list_users`` now returns user-specific permission states for paused, allow_orchestrate, allow_run_explore, and allow_view_sdk_token.

v4.4.36b1

Merge pull request #794 from superannotateai/fix_upload_annotations

version update

Improvements and bug fixes.

Added

- ``SAClient.generate_items`` Generates multiple items in a specified project and folder.

Updated

- ``SAClient.get_team_metadata`` Added a new include parameter. When set to "scores", the response includes score names associated with the team user.

Improvements and bug fixes.

Added

- ``SAClient.get_integrations`` Added id, createdAt, updatedAt, and creator_id in integration metadata.
- ``SAClient.list_workflows`` Retrieves all workflows for your team along with their metadata.

Updated
- SAClient.get_project_metadata

Removed
- SAClient.get_project_workflow
- SAClient.set_project_workflow

Improvements and bug fixes.

Added

- ``SAClient.get_user_scores`` Retrieves score metadata for a user on a specific item within a project.
- ``SAClient.user_scores`` Assigns or updates score metadata for a user on a specific item in a project.

Updated

- ``SAClient.prepare_export`` Added option for JSONL download type.
- ``SAClient.download_annotations`` Added data_spec parameter enabling annotation downloads in JSONL format for multimodal projects.
- ``SAClient.list_items`` Introduced a new parameter to filter results by item category.
- ``SAClient.list_users`` Now retrieves a list of users with their scores and includes filtering options. Added an optional project parameter to fetch project-level scores instead of team-level scores.
- ``SAClient.item_context`` Added information about the ItemContext nested class.
- ``SAClient.list_projects`` Enhanced docstrings for to improve clarity and usability.

v4.4.33b1

Full Changelog: v4.4.32...v4.4.33b1

Improvements and bug fixes.

Fixed

- ``SAClient.item_context`` Fixed an issue where setting a component value would overwrite existing comments and other associated data. 

Improvements and bug fixes.

Added

- Guide for Converting CSV and JSONL Formats.
- New SDK Functionality Table.

Updated

- ``SAClient.attach_items_from_integrated_storage`` now supports Databricks integration, enabling efficient
    data fetching and mapping from Databricks into SuperAnnotate.