pangea-sdk 3.8.0b1__py3-none-any.whl → 5.3.0__py3-none-any.whl

pangea/services/share/share.py

@@ -1,12 +1,15 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+from __future__ import annotations
+
 import enum
 import io
 from typing import Dict, List, NewType, Optional, Tuple, Union
 
-from ..base import ServiceBase
-from .file_format import FileFormat
+from pangea.config import PangeaConfig
 from pangea.response import APIRequestModel, PangeaResponse, PangeaResponseResult, TransferMethod
+from pangea.services.base import ServiceBase
+from pangea.services.share.file_format import FileFormat
 from pangea.utils import get_file_size, get_file_upload_params
 
 Metadata = NewType("Metadata", Dict[str, str])
@@ -77,7 +80,7 @@ class ItemOrderBy(str, enum.Enum):
 
 class ShareLinkOrderBy(str, enum.Enum):
     ID = "id"
-    STORAGE_POOL_ID = "storage_pool_id"
+    BUCKET_ID = "bucket_id"
     TARGET = "target"
     LINK_TYPE = "link_type"
     ACCESS_COUNT = "access_count"
@@ -96,69 +99,225 @@ class ShareLinkOrderBy(str, enum.Enum):
 
 class DeleteRequest(APIRequestModel):
     id: Optional[str] = None
+    """The ID of the object to delete."""
+
     force: Optional[bool] = None
-    path: Optional[str] = None
+    """If true, delete a folder even if it's not empty. Deletes the contents of folder as well."""
+
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
 
 
 class ItemData(PangeaResponseResult):
-    id: str
-    type: str
-    name: str
-    created_at: str
-    updated_at: str
-    size: Optional[int] = None
     billable_size: Optional[int] = None
-    location: Optional[str] = None
-    tags: Optional[Tags] = None
-    metadata: Optional[Metadata] = None
+    """The number of billable bytes (includes Metadata, Tags, etc.) for the object."""
+
+    created_at: str
+    """The date and time the object was created."""
+
+    id: str
+    """The ID of a stored object."""
+
     md5: Optional[str] = None
+    """The MD5 hash of the file contents. Cannot be written to."""
+
+    metadata: Optional[Metadata] = None
+    """A set of string-based key/value pairs used to provide additional data about an object."""
+
+    metadata_protected: Optional[Metadata] = None
+    """Protected (read-only) metadata."""
+
     sha256: Optional[str] = None
+    """The SHA256 hash of the file contents. Cannot be written to."""
+
     sha512: Optional[str] = None
+    """The SHA512 hash of the file contents. Cannot be written to."""
+
+    size: Optional[int] = None
+    """The size of the object in bytes."""
+
+    tags: Optional[Tags] = None
+    """A list of user-defined tags."""
+
+    tags_protected: Optional[Tags] = None
+    """Protected (read-only) flags."""
+
+    type: str
+    """The type of the item (file or dir). Cannot be written to."""
+
+    updated_at: str
+    """The date and time the object was last updated."""
+
+    name: str
+    """The name of the object."""
+
+    folder: str
+    """The full path to the folder the object is stored in."""
+
     parent_id: Optional[str] = None
+    """The parent ID (a folder). Blanks means the root folder."""
+
+    external_bucket_key: Optional[str] = None
+    """The key in the external bucket that contains this file."""
+
+    file_ttl: Optional[str] = None
+    """The explicit file TTL setting for this object."""
+
+    file_ttl_effective: Optional[str] = None
+    """
+    The effective file TTL setting for this object, either explicitly set or
+    inherited (see `file_ttl_from_id`.)
+    """
+
+    file_ttl_from_id: Optional[str] = None
+    """
+    The ID of the object the expiry / TTL is set from. Either a service
+    configuration, the object itself, or a parent folder.
+    """
 
 
 class DeleteResult(PangeaResponseResult):
     count: int
+    """Number of objects deleted."""
 
 
 class FolderCreateRequest(APIRequestModel):
     name: Optional[str] = None
+    """The name of an object."""
+
+    file_ttl: Optional[str] = None
+    """Duration until files within this folder are automatically deleted."""
+
     metadata: Optional[Metadata] = None
+    """A set of string-based key/value pairs used to provide additional data about an object."""
+
+    root_folder: Optional[str] = None
+    """
+    The path of a root folder to restrict the operation to. Must resolve to
+    `root_id` if also set.
+    """
+
+    root_id: Optional[str] = None
+    """
+    The ID of a root folder to restrict the operation to. Must match
+    `root_folder` if also set.
+    """
+
     parent_id: Optional[str] = None
-    path: Optional[str] = None
+    """The ID of the parent folder. Must match `folder` if also set."""
+
+    folder: Optional[str] = None
+    """The folder to place the folder in. Must match `parent_id` if also set."""
+
     tags: Optional[Tags] = None
+    """A list of user-defined tags"""
+
+    tenant_id: Optional[str] = None
+    """A tenant to associate with this request"""
+
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
 
 
 class FolderCreateResult(PangeaResponseResult):
     object: ItemData
+    """Information on the created folder."""
 
 
 class GetRequest(APIRequestModel):
     id: Optional[str] = None
-    path: Optional[str] = None
+    """The ID of the object to retrieve."""
+
+    password: Optional[str] = None
+    """If the file was protected with a password, the password to decrypt with."""
+
     transfer_method: Optional[TransferMethod] = None
+    """The requested transfer method for the file data."""
+
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
+
+    tenant_id: Optional[str] = None
+    """A tenant to associate with this request."""
 
 
 class GetResult(PangeaResponseResult):
     object: ItemData
+    """File information."""
+
     dest_url: Optional[str] = None
+    """A URL where the file can be downloaded from. (transfer_method: dest-url)"""
 
 
 class PutRequest(APIRequestModel):
+    transfer_method: Optional[TransferMethod] = None
+    """The transfer method used to upload the file data."""
+
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
+
+    size: Optional[int] = None
+    """The size (in bytes) of the file. If the upload doesn't match, the call will fail."""
+
+    crc32c: Optional[str] = None
+    """The hexadecimal-encoded CRC32C hash of the file data, which will be verified by the server if provided."""
+
+    sha256: Optional[str] = None
+    """The SHA256 hash of the file data, which will be verified by the server if provided."""
+
+    md5: Optional[str] = None
+    """The hexadecimal-encoded MD5 hash of the file data, which will be verified by the server if provided."""
+
     name: Optional[str] = None
+    """The name of the object to store."""
+
     format: Optional[FileFormat] = None
+    """The format of the file, which will be verified by the server if provided. Uploads not matching the supplied format will be rejected."""
+
     metadata: Optional[Metadata] = None
+    """A set of string-based key/value pairs used to provide additional data about an object."""
+
     mimetype: Optional[str] = None
+    """The MIME type of the file, which will be verified by the server if provided. Uploads not matching the supplied MIME type will be rejected."""
+
     parent_id: Optional[str] = None
-    path: Optional[str] = None
-    crc32c: Optional[str] = None
-    md5: Optional[str] = None
+    """The parent ID of the object (a folder). Leave blank to keep in the root folder."""
+
+    folder: Optional[str] = None
+    """The path to the parent folder. Leave blank for the root folder. Path must resolve to `parent_id` if also set."""
+
+    file_ttl: Optional[str] = None
+    """The TTL before expiry for the file."""
+
+    password: Optional[str] = None
+    """An optional password to protect the file with. Downloading the file will require this password."""
+
+    password_algorithm: Optional[str] = None
+    """An optional password algorithm to protect the file with. See symmetric vault password_algorithm."""
+
+    root_folder: Optional[str] = None
+    """
+    The path of a root folder to restrict the operation to. Must resolve to
+    `root_id` if also set.
+    """
+
+    root_id: Optional[str] = None
+    """
+    The ID of a root folder to restrict the operation to. Must match
+    `root_folder` if also set.
+    """
+
     sha1: Optional[str] = None
-    sha256: Optional[str] = None
+    """The hexadecimal-encoded SHA1 hash of the file data, which will be verified by the server if provided."""
+
     sha512: Optional[str] = None
-    size: Optional[int] = None
+    """The hexadecimal-encoded SHA512 hash of the file data, which will be verified by the server if provided."""
+
     tags: Optional[Tags] = None
-    transfer_method: Optional[TransferMethod] = None
+    """A list of user-defined tags"""
+
+    tenant_id: Optional[str] = None
+    """A tenant to associate with this request"""
 
 
 class PutResult(PangeaResponseResult):
@@ -167,15 +326,70 @@ class PutResult(PangeaResponseResult):
 
 class UpdateRequest(APIRequestModel):
     id: Optional[str]
-    path: Optional[str] = None
+    """An identifier for the file to update."""
+
+    folder: Optional[str] = None
+    """
+    Set the parent (folder). Leave blank for the root folder. Path must resolve
+    to `parent_id` if also set.
+    """
+
     add_metadata: Optional[Metadata] = None
-    remove_metadata: Optional[Metadata] = None
-    metadata: Optional[Metadata] = None
+    """A list of Metadata key/values to set in the object. If a provided key exists, the value will be replaced."""
+
+    add_password: Optional[str] = None
+    """Protect the file with the supplied password."""
+
+    add_password_algorithm: Optional[str] = None
+    """The algorithm to use to password protect the file."""
+
     add_tags: Optional[Tags] = None
+    """A list of Tags to add. It is not an error to provide a tag which already exists."""
+
+    file_ttl: Optional[str] = None
+    """Set the file TTL."""
+
+    name: Optional[str] = None
+    """Sets the object's Name."""
+
+    metadata: Optional[Metadata] = None
+    """Set the object's metadata."""
+
+    remove_metadata: Optional[Metadata] = None
+    """A list of metadata key/values to remove in the object. It is not an error for a provided key to not exist. If a provided key exists but doesn't match the provided value, it will not be removed."""
+
+    remove_password: Optional[str] = None
+    """Remove the supplied password from the file."""
+
     remove_tags: Optional[Tags] = None
-    tags: Optional[Tags] = None
+    """A list of tags to remove. It is not an error to provide a tag which is not present."""
+
+    root_folder: Optional[str] = None
+    """
+    The path of a root folder to restrict the operation to. Must resolve to
+    `root_id` if also set.
+    """
+
+    root_id: Optional[str] = None
+    """
+    The ID of a root folder to restrict the operation to. Must match
+    `root_folder` if also set.
+    """
+
     parent_id: Optional[str] = None
+    """Set the parent (folder) of the object. Can be an empty string for the root folder."""
+
+    tags: Optional[Tags] = None
+    """Set the object's tags."""
+
+    tenant_id: Optional[str] = None
+    """A tenant to associate with this request."""
+
     updated_at: Optional[str] = None
+    """The date and time the object was last updated. If included, the update will fail if this doesn't match the date and time of the last update for the object."""
+
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
 
 
 class UpdateResult(PangeaResponseResult):
@@ -183,49 +397,179 @@ class UpdateResult(PangeaResponseResult):
 
 
 class FilterList(APIRequestModel):
-    folder: str
+    created_at: Optional[str] = None
+    """Only records where created_at equals this value."""
+
+    created_at__gt: Optional[str] = None
+    """Only records where created_at is greater than this value."""
+
+    created_at__gte: Optional[str] = None
+    """Only records where created_at is greater than or equal to this value."""
+
+    created_at__lt: Optional[str] = None
+    """Only records where created_at is less than this value."""
+
+    created_at__lte: Optional[str] = None
+    """Only records where created_at is less than or equal to this value."""
+
+    folder: Optional[str] = None
+    """Only records where the object exists in the supplied parent folder path name."""
+
+    id: Optional[str] = None
+    """Only records where id equals this value."""
+
+    id__in: Optional[List[str]] = None
+    """Only records where id equals one of the provided substrings."""
+
+    name: Optional[str] = None
+    """Only records where name equals this value."""
+
+    name__contains: Optional[List[str]] = None
+    """Only records where name includes each substring."""
+
+    name__in: Optional[List[str]] = None
+    """Only records where name equals one of the provided substrings."""
+
+    parent_id: Optional[str] = None
+    """Only records where parent_id equals this value."""
+
+    parent_id__in: Optional[List[str]] = None
+    """Only records where parent_id equals one of the provided substrings."""
+
+    size: Optional[int] = None
+    """Only records where size equals this value."""
+
+    size__gt: Optional[int] = None
+    """Only records where size is greater than this value."""
+
+    size__gte: Optional[int] = None
+    """Only records where size is greater than or equal to this value."""
+
+    size__lt: Optional[int] = None
+    """Only records where size is less than to this value."""
+
+    size__lte: Optional[int] = None
+    """Only records where size is less than or equal to this value."""
+
+    tags: Optional[List[str]] = None
+    """A list of tags that all must be present."""
+
+    type: Optional[str] = None
+    """Only records where type equals this value."""
+
+    type__contains: Optional[List[str]] = None
+    """Only records where type includes each substring."""
+
+    type__in: Optional[List[str]] = None
+    """Only records where type equals one of the provided substrings."""
+
+    updated_at: Optional[str] = None
+    """Only records where updated_at equals this value."""
+
+    updated_at__gt: Optional[str] = None
+    """Only records where updated_at is greater than this value."""
+
+    updated_at__gte: Optional[str] = None
+    """Only records where updated_at is greater than or equal to this value."""
+
+    updated_at__lt: Optional[str] = None
+    """Only records where updated_at is less than this value."""
+
+    updated_at__lte: Optional[str] = None
+    """Only records where updated_at is less than or equal to this value."""
 
 
 class ListRequest(APIRequestModel):
     filter: Optional[Union[Dict[str, str], FilterList]] = None
     last: Optional[str] = None
+    """Reflected value from a previous response to obtain the next page of results."""
+
     order: Optional[ItemOrder] = None
+    """Order results asc(ending) or desc(ending)."""
+
     order_by: Optional[ItemOrderBy] = None
+    """Which field to order results by."""
+
     size: Optional[int] = None
+    """Maximum results to include in the response."""
+
+    include_external_bucket_key: bool = False
+    """If true, include the `external_bucket_key` in results."""
+
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
 
 
 class ListResult(PangeaResponseResult):
     count: int
+    """The total number of objects matched by the list request."""
+
     last: Optional[str] = None
+    """Used to fetch the next page of the current listing when provided in a repeated request's last parameter."""
+
     objects: List[ItemData]
 
 
 class GetArchiveRequest(APIRequestModel):
     ids: List[str] = []
+    """The IDs of the objects to include in the archive. Folders include all children."""
+
     format: Optional[ArchiveFormat] = None
+    """The format to use to build the archive."""
+
     transfer_method: Optional[TransferMethod] = None
+    """The requested transfer method for the file data."""
+
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
 
 
 class GetArchiveResult(PangeaResponseResult):
-    dest_url: Optional[str] = None
     count: int
+    """Number of objects included in the archive."""
+
+    dest_url: Optional[str] = None
+    """A location where the archive can be downloaded from. (transfer_method: dest-url)"""
+
+    objects: List[ItemData] = []
+    """A list of all objects included in the archive."""
 
 
 class Authenticator(PangeaResponseResult):
     auth_type: AuthenticatorType
+    """An authentication mechanism."""
+
     auth_context: str
+    """An email address, a phone number or a password to access share link."""
 
 
 class ShareLinkItemBase(PangeaResponseResult):
     targets: List[str] = []
+    """List of storage IDs."""
+
     link_type: Optional[LinkType] = None
+    """Type of link."""
+
     expires_at: Optional[str] = None
+    """The date and time the share link expires."""
+
     max_access_count: Optional[int] = None
-    authenticators: List[Authenticator]
-    message: Optional[str] = None
+    """The maximum number of times a user can be authenticated to access the share link."""
+
+    authenticators: Optional[List[Authenticator]] = None
+    """A list of authenticators."""
+
     title: Optional[str] = None
+    """An optional title to use in accessing shares."""
+
+    message: Optional[str] = None
+    """An optional message to use in accessing shares."""
+
     notify_email: Optional[str] = None
+    """An email address"""
+
     tags: Optional[Tags] = None
+    """A list of user-defined tags"""
 
 
 class ShareLinkCreateItem(ShareLinkItemBase):
@@ -234,15 +578,28 @@ class ShareLinkCreateItem(ShareLinkItemBase):
 
 class ShareLinkCreateRequest(APIRequestModel):
     links: List[ShareLinkCreateItem] = []
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
 
 
 class ShareLinkItem(ShareLinkItemBase):
     id: str
-    storage_pool_id: str
+    """The ID of a share link."""
+
     access_count: int
+    """The number of times a user has authenticated to access the share link."""
+
     created_at: str
+    """The date and time the share link was created."""
+
     last_accessed_at: Optional[str] = None
-    link: str
+    """The date and time the share link was last accessed."""
+
+    link: Optional[str] = None
+    """A URL to access the file/folders shared with a link."""
+
+    bucket_id: str
+    """The ID of a share bucket resource."""
 
 
 class ShareLinkCreateResult(PangeaResponseResult):
@@ -251,6 +608,7 @@ class ShareLinkCreateResult(PangeaResponseResult):
 
 class ShareLinkGetRequest(APIRequestModel):
     id: str
+    """The ID of a share link."""
 
 
 class ShareLinkGetResult(PangeaResponseResult):
@@ -261,9 +619,6 @@ class FilterShareLinkList(APIRequestModel):
     id: Optional[str] = None
     id__contains: Optional[List[str]] = None
     id__in: Optional[List[str]] = None
-    storage_pool_id: Optional[str] = None
-    storage_pool_id__contains: Optional[List[str]] = None
-    storage_pool_id__in: Optional[List[str]] = None
     target: Optional[str] = None
     target__contains: Optional[List[str]] = None
     target__in: Optional[List[str]] = None
@@ -298,23 +653,51 @@ class FilterShareLinkList(APIRequestModel):
     link: Optional[str] = None
     link__contains: Optional[List[str]] = None
     link__in: Optional[List[str]] = None
+    title: Optional[str] = None
+    title__contains: Optional[List[str]] = None
+    title__in: Optional[List[str]] = None
+    message: Optional[str] = None
+    message__contains: Optional[List[str]] = None
+    message__in: Optional[List[str]] = None
+    notify_email: Optional[str] = None
+    notify_email__contains: Optional[List[str]] = None
+    notify_email__in: Optional[List[str]] = None
+    tags: Optional[List[str]] = None
 
 
 class ShareLinkListRequest(APIRequestModel):
     filter: Optional[Union[FilterShareLinkList, Dict[str, str]]] = None
+
     last: Optional[str] = None
+    """Reflected value from a previous response to obtain the next page of results."""
+
     order: Optional[ItemOrder] = None
+    """Order results asc(ending) or desc(ending)."""
+
     order_by: Optional[ShareLinkOrderBy] = None
+    """Which field to order results by."""
+
     size: Optional[int] = None
+    """Maximum results to include in the response."""
+
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
 
 
 class ShareLinkListResult(PangeaResponseResult):
     count: int
+    """The total number of share links matched by the list request."""
+
+    last: Optional[str] = None
+    """Used to fetch the next page of the current listing when provided in a repeated request's last parameter."""
+
     share_link_objects: List[ShareLinkItem] = []
 
 
 class ShareLinkDeleteRequest(APIRequestModel):
     ids: List[str]
+    bucket_id: Optional[str] = None
+    """The bucket to use, if not the default."""
 
 
 class ShareLinkDeleteResult(PangeaResponseResult):
@@ -328,34 +711,96 @@ class ShareLinkSendItem(APIRequestModel):
 
 class ShareLinkSendRequest(APIRequestModel):
     links: List[ShareLinkSendItem]
+
     sender_email: str
+    """An email address."""
+
     sender_name: Optional[str]
+    """The sender name information. Can be sender's full name for example."""
 
 
 class ShareLinkSendResult(PangeaResponseResult):
     share_link_objects: List[ShareLinkItem]
 
 
+class Bucket(PangeaResponseResult):
+    id: str
+    """The ID of a share bucket resource."""
+
+    default: bool
+    """If true, is the default bucket."""
+
+    name: str
+    """The bucket's friendly name."""
+
+    transfer_methods: List[TransferMethod]
+
+
+class BucketsResult(PangeaResponseResult):
+    buckets: List[Bucket]
+    """A list of available buckets."""
+
+
 class Share(ServiceBase):
-    """Share service client."""
+    """Secure Share service client."""
 
     service_name = "share"
 
+    def __init__(
+        self, token: str, config: PangeaConfig | None = None, logger_name: str = "pangea", config_id: str | None = None
+    ) -> None:
+        """
+        Secure Share client
+
+        Initializes a new Secure Share client.
+
+        Args:
+            token: Pangea API token.
+            config: Configuration.
+            logger_name: Logger name.
+            config_id: Configuration ID.
+
+        Examples:
+             config = PangeaConfig(domain="aws.us.pangea.cloud")
+             authz = Share(token="pangea_token", config=config)
+        """
+
+        super().__init__(token, config, logger_name, config_id=config_id)
+
+    def buckets(self) -> PangeaResponse[BucketsResult]:
+        """
+        Buckets
+
+        Get information on the accessible buckets.
+
+        OperationId: share_post_v1_buckets
+
+        Returns:
+            A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
+
+        Examples:
+            response = share.buckets()
+        """
+        return self.request.post("v1/buckets", BucketsResult)
+
     def delete(
-        self, id: Optional[str] = None, path: Optional[str] = None, force: Optional[bool] = None
+        self,
+        id: Optional[str] = None,
+        force: Optional[bool] = None,
+        bucket_id: Optional[str] = None,
     ) -> PangeaResponse[DeleteResult]:
         """
         Delete
 
         Delete object by ID or path. If both are supplied, the path must match
-        that of the object represented by the ID. Beta API.
+        that of the object represented by the ID.
 
-        OperationId: share_post_v1beta_delete
+        OperationId: share_post_v1_delete
 
         Args:
             id (str, optional): The ID of the object to delete.
-            path (str, optional): The path of the object to delete.
             force (bool, optional): If true, delete a folder even if it's not empty.
+            bucket_id (str, optional): The bucket to use, if not the default.
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -363,30 +808,45 @@ class Share(ServiceBase):
         Examples:
             response = share.delete(id="pos_3djfmzg2db4c6donarecbyv5begtj2bm")
         """
-        input = DeleteRequest(id=id, path=path, force=force)
-        return self.request.post("v1beta/delete", DeleteResult, data=input.dict(exclude_none=True))
+        input = DeleteRequest(id=id, force=force, bucket_id=bucket_id)
+        return self.request.post("v1/delete", DeleteResult, data=input.model_dump(exclude_none=True))
 
     def folder_create(
         self,
         name: Optional[str] = None,
         metadata: Optional[Metadata] = None,
         parent_id: Optional[str] = None,
-        path: Optional[str] = None,
+        folder: Optional[str] = None,
         tags: Optional[Tags] = None,
+        bucket_id: Optional[str] = None,
+        *,
+        file_ttl: Optional[str] = None,
+        root_folder: Optional[str] = None,
+        root_id: Optional[str] = None,
+        tenant_id: Optional[str] = None,
     ) -> PangeaResponse[FolderCreateResult]:
         """
         Create a folder
 
-        Create a folder, either by name or path and parent_id. Beta API.
+        Create a folder, either by name or path and parent_id.
 
-        OperationId: share_post_v1beta_folder_create
+        OperationId: share_post_v1_folder_create
 
         Args:
             name (str, optional): The name of an object.
             metadata (Metadata, optional): A set of string-based key/value pairs used to provide additional data about an object.
             parent_id (str, optional): The ID of a stored object.
-            path (str, optional): A case-sensitive path to an object. Contains a sequence of path segments delimited by the the / character. Any path ending in a / character refers to a folder.
+            folder (str, optional): The folder to place the folder in. Must
+              match `parent_id` if also set.
             tags (Tags, optional): A list of user-defined tags.
+            bucket_id (str, optional): The bucket to use, if not the default.
+            file_ttl: Duration until files within this folder are automatically
+              deleted.
+            root_folder: The path of a root folder to restrict the operation to.
+              Must resolve to `root_id` if also set.
+            root_id: The ID of a root folder to restrict the operation to. Must
+              match `root_folder` if also set.
+            tenant_id: A tenant to associate with this request
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -398,28 +858,47 @@ class Share(ServiceBase):
                     "priority": "medium",
                 },
                 parent_id="pos_3djfmzg2db4c6donarecbyv5begtj2bm",
-                path="/",
+                folder="/",
                 tags=["irs_2023", "personal"],
             )
         """
-        input = FolderCreateRequest(name=name, metadata=metadata, parent_id=parent_id, path=path, tags=tags)
-        return self.request.post("v1beta/folder/create", FolderCreateResult, data=input.dict(exclude_none=True))
+        input = FolderCreateRequest(
+            name=name,
+            metadata=metadata,
+            parent_id=parent_id,
+            folder=folder,
+            tags=tags,
+            bucket_id=bucket_id,
+            file_ttl=file_ttl,
+            root_folder=root_folder,
+            root_id=root_id,
+            tenant_id=tenant_id,
+        )
+        return self.request.post("v1/folder/create", FolderCreateResult, data=input.model_dump(exclude_none=True))
 
     def get(
-        self, id: Optional[str] = None, path: Optional[str] = None, transfer_method: Optional[TransferMethod] = None
+        self,
+        id: Optional[str] = None,
+        transfer_method: Optional[TransferMethod] = None,
+        bucket_id: Optional[str] = None,
+        password: Optional[str] = None,
+        *,
+        tenant_id: Optional[str] = None,
     ) -> PangeaResponse[GetResult]:
         """
         Get an object
 
         Get object. If both ID and Path are supplied, the call will fail if the
-        target object doesn't match both properties. Beta API.
+        target object doesn't match both properties.
 
-        OperationId: share_post_v1beta_get
+        OperationId: share_post_v1_get
 
         Args:
             id (str, optional): The ID of the object to retrieve.
-            path (str, optional): The path of the object to retrieve.
             transfer_method (TransferMethod, optional): The requested transfer method for the file data.
+            bucket_id (str, optional): The bucket to use, if not the default.
+            password (str, optional): If the file was protected with a password, the password to decrypt with.
+            tenant_id: A tenant to associate with this request.
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -427,33 +906,33 @@ class Share(ServiceBase):
         Examples:
             response = share.get(
                 id="pos_3djfmzg2db4c6donarecbyv5begtj2bm",
-                path="/",
+                folder="/",
             )
         """
         input = GetRequest(
-            id=id,
-            path=path,
-            transfer_method=transfer_method,
+            id=id, transfer_method=transfer_method, bucket_id=bucket_id, password=password, tenant_id=tenant_id
         )
-        return self.request.post("v1beta/get", GetResult, data=input.dict(exclude_none=True))
+        return self.request.post("v1/get", GetResult, data=input.model_dump(exclude_none=True))
 
     def get_archive(
         self,
         ids: List[str] = [],
         format: Optional[ArchiveFormat] = None,
         transfer_method: Optional[TransferMethod] = None,
+        bucket_id: Optional[str] = None,
     ) -> PangeaResponse[GetArchiveResult]:
         """
         Get archive
 
-        Get an archive file of multiple objects. Beta API.
+        Get an archive file of multiple objects.
 
-        OperationId: share_post_v1beta_get_archive
+        OperationId: share_post_v1_get_archive
 
         Args:
             ids (List[str]): The IDs of the objects to include in the archive. Folders include all children.
             format (ArchiveFormat, optional): The format to use for the built archive.
             transfer_method (TransferMethod, optional): The requested transfer method for the file data.
+            bucket_id (str, optional): The bucket to use, if not the default.
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -470,8 +949,8 @@ class Share(ServiceBase):
         ):
             raise ValueError(f"Only {TransferMethod.DEST_URL} and {TransferMethod.MULTIPART} are supported")
 
-        input = GetArchiveRequest(ids=ids, format=format, transfer_method=transfer_method)
-        return self.request.post("v1beta/get_archive", GetArchiveResult, data=input.dict(exclude_none=True))
+        input = GetArchiveRequest(ids=ids, format=format, transfer_method=transfer_method, bucket_id=bucket_id)
+        return self.request.post("v1/get_archive", GetArchiveResult, data=input.model_dump(exclude_none=True))
 
     def list(
         self,
@@ -480,13 +959,14 @@ class Share(ServiceBase):
         order: Optional[ItemOrder] = None,
         order_by: Optional[ItemOrderBy] = None,
         size: Optional[int] = None,
+        bucket_id: Optional[str] = None,
     ) -> PangeaResponse[ListResult]:
         """
         List
 
-        List or filter/search records. Beta API.
+        List or filter/search records.
 
-        OperationId: share_post_v1beta_list
+        OperationId: share_post_v1_list
 
         Args:
             filter (Union[Dict[str, str], FilterList], optional):
@@ -494,6 +974,7 @@ class Share(ServiceBase):
             order (ItemOrder, optional): Order results asc(ending) or desc(ending).
             order_by (ItemOrderBy, optional): Which field to order results by.
             size (int, optional): Maximum results to include in the response.
+            bucket_id (str, optional): The bucket to use, if not the default.
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -501,14 +982,14 @@ class Share(ServiceBase):
         Examples:
             response = share.list()
         """
-        input = ListRequest(filter=filter, last=last, order=order, order_by=order_by, size=size)
-        return self.request.post("v1beta/list", ListResult, data=input.dict(exclude_none=True))
+        input = ListRequest(filter=filter, last=last, order=order, order_by=order_by, size=size, bucket_id=bucket_id)
+        return self.request.post("v1/list", ListResult, data=input.model_dump(exclude_none=True))
 
     def put(
         self,
         file: io.BufferedReader,
         name: Optional[str] = None,
-        path: Optional[str] = None,
+        folder: Optional[str] = None,
         format: Optional[FileFormat] = None,
         metadata: Optional[Metadata] = None,
         mimetype: Optional[str] = None,
@@ -521,18 +1002,27 @@ class Share(ServiceBase):
         sha256: Optional[str] = None,
         sha512: Optional[str] = None,
         size: Optional[int] = None,
+        bucket_id: Optional[str] = None,
+        password: Optional[str] = None,
+        password_algorithm: Optional[str] = None,
+        *,
+        file_ttl: Optional[str] = None,
+        root_folder: Optional[str] = None,
+        root_id: Optional[str] = None,
+        tenant_id: Optional[str] = None,
     ) -> PangeaResponse[PutResult]:
         """
         Upload a file
 
-        Upload a file. Beta API.
+        Upload a file.
 
-        OperationId: share_post_v1beta_put
+        OperationId: share_post_v1_put
 
         Args:
             file (io.BufferedReader):
             name (str, optional): The name of the object to store.
-            path (str, optional): An optional path where the file should be placed. Will auto-create directories if necessary.
+            folder (str, optional): The path to the parent folder. Leave blank
+              for the root folder. Path must resolve to `parent_id` if also set.
             format (FileFormat, optional): The format of the file, which will be verified by the server if provided. Uploads not matching the supplied format will be rejected.
             metadata (Metadata, optional): A set of string-based key/value pairs used to provide additional data about an object.
             mimetype (str, optional): The MIME type of the file, which will be verified by the server if provided. Uploads not matching the supplied MIME type will be rejected.
@@ -545,6 +1035,15 @@ class Share(ServiceBase):
             sha256 (str, optional): The SHA256 hash of the file data, which will be verified by the server if provided.
             sha512 (str, optional): The hexadecimal-encoded SHA512 hash of the file data, which will be verified by the server if provided.
             size (str, optional): The size (in bytes) of the file. If the upload doesn't match, the call will fail.
+            bucket_id (str, optional): The bucket to use, if not the default.
+            password (str, optional): An optional password to protect the file with. Downloading the file will require this password.
+            password_algorithm (str, optional): An optional password algorithm to protect the file with. See symmetric vault password_algorithm.
+            file_ttl: The TTL before expiry for the file.
+            root_folder: The path of a root folder to restrict the operation to.
+              Must resolve to `root_id` if also set.
+            root_id: The ID of a root folder to restrict the operation to. Must
+              match `root_folder` if also set.
+            tenant_id: A tenant to associate with this request.
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -576,7 +1075,7 @@ class Share(ServiceBase):
             metadata=metadata,
             mimetype=mimetype,
             parent_id=parent_id,
-            path=path,
+            folder=folder,
             tags=tags,
             transfer_method=transfer_method,
             crc32c=crc32c,
@@ -585,14 +1084,21 @@ class Share(ServiceBase):
             sha256=sha256,
             sha512=sha512,
             size=size,
+            bucket_id=bucket_id,
+            password=password,
+            password_algorithm=password_algorithm,
+            file_ttl=file_ttl,
+            root_folder=root_folder,
+            root_id=root_id,
+            tenant_id=tenant_id,
         )
-        data = input.dict(exclude_none=True)
-        return self.request.post("v1beta/put", PutResult, data=data, files=files)
+        data = input.model_dump(exclude_none=True)
+        return self.request.post("v1/put", PutResult, data=data, files=files)
 
     def request_upload_url(
         self,
         name: Optional[str] = None,
-        path: Optional[str] = None,
+        folder: Optional[str] = None,
         format: Optional[FileFormat] = None,
         metadata: Optional[Metadata] = None,
         mimetype: Optional[str] = None,
@@ -605,17 +1111,26 @@ class Share(ServiceBase):
         crc32c: Optional[str] = None,
         sha256: Optional[str] = None,
         size: Optional[int] = None,
+        bucket_id: Optional[str] = None,
+        *,
+        file_ttl: Optional[str] = None,
+        password: Optional[str] = None,
+        password_algorithm: Optional[str] = None,
+        root_folder: Optional[str] = None,
+        root_id: Optional[str] = None,
+        tenant_id: Optional[str] = None,
     ) -> PangeaResponse[PutResult]:
         """
         Request upload URL
 
-        Request an upload URL. Beta API.
+        Request an upload URL.
 
-        OperationId: share_post_v1beta_put 2
+        OperationId: share_post_v1_put 2
 
         Args:
             name (str, optional): The name of the object to store.
-            path (str, optional): An optional path where the file should be placed. Will auto-create directories if necessary.
+            folder (str, optional): The path to the parent folder. Leave blank
+              for the root folder. Path must resolve to `parent_id` if also set.
             format (FileFormat, optional): The format of the file, which will be verified by the server if provided. Uploads not matching the supplied format will be rejected.
             metadata (Metadata, optional): A set of string-based key/value pairs used to provide additional data about an object.
             mimetype (str, optional): The MIME type of the file, which will be verified by the server if provided. Uploads not matching the supplied MIME type will be rejected.
@@ -628,6 +1143,17 @@ class Share(ServiceBase):
             crc32c (str, optional): The hexadecimal-encoded CRC32C hash of the file data, which will be verified by the server if provided.
             sha256 (str, optional): The SHA256 hash of the file data, which will be verified by the server if provided.
             size (str, optional): The size (in bytes) of the file. If the upload doesn't match, the call will fail.
+            bucket_id (str, optional): The bucket to use, if not the default.
+            file_ttl: The TTL before expiry for the file.
+            password: An optional password to protect the file with. Downloading
+              the file will require this password.
+            password_algorithm: An optional password algorithm to protect the
+              file with. See symmetric vault password_algorithm.
+            root_folder: The path of a root folder to restrict the operation to.
+              Must resolve to `root_id` if also set.
+            root_id: The ID of a root folder to restrict the operation to. Must
+              match `root_folder` if also set.
+            tenant_id: A tenant to associate with this request.
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -643,7 +1169,7 @@ class Share(ServiceBase):
                     "priority": "medium",
                 },
                 parent_id="pos_3djfmzg2db4c6donarecbyv5begtj2bm",
-                path="/",
+                folder="/",
                 tags=["irs_2023", "personal"],
             )
         """
@@ -653,7 +1179,7 @@ class Share(ServiceBase):
             metadata=metadata,
             mimetype=mimetype,
             parent_id=parent_id,
-            path=path,
+            folder=folder,
             tags=tags,
             transfer_method=transfer_method,
             crc32c=crc32c,
@@ -662,15 +1188,22 @@ class Share(ServiceBase):
             sha256=sha256,
             sha512=sha512,
             size=size,
+            bucket_id=bucket_id,
+            file_ttl=file_ttl,
+            password=password,
+            password_algorithm=password_algorithm,
+            root_folder=root_folder,
+            root_id=root_id,
+            tenant_id=tenant_id,
         )
 
-        data = input.dict(exclude_none=True)
-        return self.request.request_presigned_url("v1beta/put", PutResult, data=data)
+        data = input.model_dump(exclude_none=True)
+        return self.request.request_presigned_url("v1/put", PutResult, data=data)
 
     def update(
         self,
         id: Optional[str] = None,
-        path: Optional[str] = None,
+        folder: Optional[str] = None,
         add_metadata: Optional[Metadata] = None,
         remove_metadata: Optional[Metadata] = None,
         metadata: Optional[Metadata] = None,
@@ -679,17 +1212,27 @@ class Share(ServiceBase):
         tags: Optional[Tags] = None,
         parent_id: Optional[str] = None,
         updated_at: Optional[str] = None,
+        bucket_id: Optional[str] = None,
+        *,
+        add_password: Optional[str] = None,
+        add_password_algorithm: Optional[str] = None,
+        remove_password: Optional[str] = None,
+        file_ttl: Optional[str] = None,
+        root_folder: Optional[str] = None,
+        root_id: Optional[str] = None,
+        tenant_id: Optional[str] = None,
     ) -> PangeaResponse[UpdateResult]:
         """
         Update a file
 
-        Update a file. Beta API.
+        Update a file.
 
-        OperationId: share_post_v1beta_update
+        OperationId: share_post_v1_update
 
         Args:
             id (str, optional): An identifier for the file to update.
-            path (str, optional): An alternative to ID for providing the target file.
+            folder (str, optional): Set the parent (folder). Leave blank for the
+              root folder. Path must resolve to `parent_id` if also set.
             add_metadata (Metadata, optional): A list of Metadata key/values to set in the object. If a provided key exists, the value will be replaced.
             remove_metadata (Metadata, optional): A list of Metadata key/values to remove in the object. It is not an error for a provided key to not exist. If a provided key exists but doesn't match the provided value, it will not be removed.
             metadata (Metadata, optional): Set the object's Metadata.
@@ -698,6 +1241,17 @@ class Share(ServiceBase):
             tags (Tags, optional): Set the object's Tags.
             parent_id (str, optional): Set the parent (folder) of the object.
             updated_at (str, optional): The date and time the object was last updated. If included, the update will fail if this doesn't match what's stored.
+            bucket_id (str, optional): The bucket to use, if not the default.
+            add_password: Protect the file with the supplied password.
+            add_password_algorithm: The algorithm to use to password protect the
+              file.
+            remove_password: Remove the supplied password from the file.
+            file_ttl: Set the file TTL.
+            root_folder: The path of a root folder to restrict the operation to.
+              Must resolve to `root_id` if also set.
+            root_id: The ID of a root folder to restrict the operation to. Must
+              match `root_folder` if also set.
+            tenant_id: A tenant to associate with this request.
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -713,8 +1267,8 @@ class Share(ServiceBase):
             )
         """
         input = UpdateRequest(
-            id=id,  # noqa: F401
-            path=path,
+            id=id,
+            folder=folder,
             add_metadata=add_metadata,
             remove_metadata=remove_metadata,
             metadata=metadata,
@@ -723,19 +1277,30 @@ class Share(ServiceBase):
             tags=tags,
             parent_id=parent_id,
             updated_at=updated_at,
+            bucket_id=bucket_id,
+            add_password=add_password,
+            add_password_algorithm=add_password_algorithm,
+            remove_password=remove_password,
+            file_ttl=file_ttl,
+            root_folder=root_folder,
+            root_id=root_id,
+            tenant_id=tenant_id,
         )
-        return self.request.post("v1beta/update", UpdateResult, data=input.dict(exclude_none=True))
+        return self.request.post("v1/update", UpdateResult, data=input.model_dump(exclude_none=True))
 
-    def share_link_create(self, links: List[ShareLinkCreateItem]) -> PangeaResponse[ShareLinkCreateResult]:
+    def share_link_create(
+        self, links: List[ShareLinkCreateItem], bucket_id: Optional[str] = None
+    ) -> PangeaResponse[ShareLinkCreateResult]:
         """
         Create share links
 
-        Create a share link. Beta API.
+        Create a share link.
 
-        OperationId: share_post_v1beta_share_link_create
+        OperationId: share_post_v1_share_link_create
 
         Args:
             links (List[ShareLinkCreateItem]):
+            bucket_id (str, optional): The bucket to use, if not the default.
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -756,16 +1321,18 @@ class Share(ServiceBase):
                 ],
             )
         """
-        input = ShareLinkCreateRequest(links=links)
-        return self.request.post("v1beta/share/link/create", ShareLinkCreateResult, data=input.dict(exclude_none=True))
+        input = ShareLinkCreateRequest(links=links, bucket_id=bucket_id)
+        return self.request.post(
+            "v1/share/link/create", ShareLinkCreateResult, data=input.model_dump(exclude_none=True)
+        )
 
     def share_link_get(self, id: str) -> PangeaResponse[ShareLinkGetResult]:
         """
         Get share link
 
-        Get a share link. Beta API.
+        Get a share link.
 
-        OperationId: share_post_v1beta_share_link_get
+        OperationId: share_post_v1_share_link_get
 
         Args:
             id (str, optional): The ID of a share link.
@@ -779,7 +1346,7 @@ class Share(ServiceBase):
             )
         """
         input = ShareLinkGetRequest(id=id)
-        return self.request.post("v1beta/share/link/get", ShareLinkGetResult, data=input.dict(exclude_none=True))
+        return self.request.post("v1/share/link/get", ShareLinkGetResult, data=input.model_dump(exclude_none=True))
 
     def share_link_list(
         self,
@@ -788,13 +1355,14 @@ class Share(ServiceBase):
         order: Optional[ItemOrder] = None,
         order_by: Optional[ShareLinkOrderBy] = None,
         size: Optional[int] = None,
+        bucket_id: Optional[str] = None,
     ) -> PangeaResponse[ShareLinkListResult]:
         """
         List share links
 
-        Look up share links by filter options. Beta API.
+        Look up share links by filter options.
 
-        OperationId: share_post_v1beta_share_link_list
+        OperationId: share_post_v1_share_link_list
 
         Args:
             filter (Union[Dict[str, str], ShareLinkListFilter], optional):
@@ -802,6 +1370,7 @@ class Share(ServiceBase):
             order (ItemOrder, optional): Order results asc(ending) or desc(ending).
             order_by (ItemOrderBy, optional): Which field to order results by.
             size (int, optional): Maximum results to include in the response.
+            bucket_id (str, optional): The bucket to use, if not the default.
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -809,19 +1378,24 @@ class Share(ServiceBase):
         Examples:
             response = share.share_link_list()
         """
-        input = ShareLinkListRequest(filter=filter, last=last, order=order, order_by=order_by, size=size)
-        return self.request.post("v1beta/share/link/list", ShareLinkListResult, data=input.dict(exclude_none=True))
+        input = ShareLinkListRequest(
+            filter=filter, last=last, order=order, order_by=order_by, size=size, bucket_id=bucket_id
+        )
+        return self.request.post("v1/share/link/list", ShareLinkListResult, data=input.model_dump(exclude_none=True))
 
-    def share_link_delete(self, ids: List[str]) -> PangeaResponse[ShareLinkDeleteResult]:
+    def share_link_delete(
+        self, ids: List[str], bucket_id: Optional[str] = None
+    ) -> PangeaResponse[ShareLinkDeleteResult]:
         """
         Delete share links
 
-        Delete share links. Beta API.
+        Delete share links.
 
-        OperationId: share_post_v1beta_share_link_delete
+        OperationId: share_post_v1_share_link_delete
 
         Args:
             ids (List[str]): list of the share link's id to delete
+            bucket_id (str, optional): The bucket to use, if not the default
 
         Returns:
             A PangeaResponse. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/share).
@@ -831,8 +1405,10 @@ class Share(ServiceBase):
                 ids=["psl_3djfmzg2db4c6donarecbyv5begtj2bm"]
             )
         """
-        input = ShareLinkDeleteRequest(ids=ids)
-        return self.request.post("v1beta/share/link/delete", ShareLinkDeleteResult, data=input.dict(exclude_none=True))
+        input = ShareLinkDeleteRequest(ids=ids, bucket_id=bucket_id)
+        return self.request.post(
+            "v1/share/link/delete", ShareLinkDeleteResult, data=input.model_dump(exclude_none=True)
+        )
 
     def share_link_send(
         self, links: List[ShareLinkSendItem], sender_email: str, sender_name: Optional[str] = None
@@ -843,9 +1419,9 @@ class Share(ServiceBase):
         Send a secure share-link notification to a set of email addresses. The
         notification email will contain an Open button that the recipient can
         use to follow the secured share-link to authenticate and then access the
-        shared content. Beta API.
+        shared content.
 
-        OperationId: share_post_v1beta_share_link_send
+        OperationId: share_post_v1_share_link_send
 
         Args:
             sender_email: An email address.
@@ -861,4 +1437,4 @@ class Share(ServiceBase):
         """
 
         input = ShareLinkSendRequest(links=links, sender_email=sender_email, sender_name=sender_name)
-        return self.request.post("v1beta/share/link/send", ShareLinkSendResult, data=input.dict(exclude_none=True))
+        return self.request.post("v1/share/link/send", ShareLinkSendResult, data=input.model_dump(exclude_none=True))