Skip to main content
Version: 2026.09

Models and artifacts

Methods for uploading, updating, and managing models, artifacts, comments, and revisions on the Istari Digital Platform.

All methods below are on the Client instance. Parameters marked (required) must be provided. See Enums for valid enum values and Pagination for page/size defaults.

In 13.1.9 the model, artifact, file, revision, and resource routes on Client are deprecated and emit DeprecationWarning. New code uses V3Client. The method map pairs each deprecated call with its replacement, and each deprecated entry below links to that call. Storage helpers (create_revision, read_contents) and the control-tag calls are not part of this deprecation.

Upload with create_resource and resource_type="model". That registers a model: a Resource you can share, track in a System, and run jobs on. Use resource_type="artifact" to attach an output to a model you already have. v3 in the example is a V3Client.

model = v3.create_resource("bracket.stl", resource_type="model", display_name="Bracket")
print(model.resource_id)

create_resource returns a ResourceDto. The deprecated Client methods further down still return a Model or Artifact, and each includes its storage File (model.file, artifact.file).

Upload vs connected Resources​

  • Upload — pass path to the real file bytes (.stl, .mdzip, .xlsx, …).
  • Connect — pass path to a JSON metadata pointer file (extension .istari_{tool_key}_metadata, with optional suffixes per module). create_resource with resource_type="model" takes that path. The deprecated add_model and update_model methods do the same.

See Connected resources for integration extensions, job examples, and revision behavior. For V3Client, see Connected resources (V3Client).

Files​

These methods read and update the storage File on a model or artifact (model.file, artifact.file). To upload a Resource, use create_resource.

update_file()​

Deprecated in 13.1.9. Use create_resource_revision.

Update an existing file with a new version and optional metadata.

This method replaces the contents of a file by uploading a new version from the specified path. You can also update metadata such as sources, description, version name, or external identifier.

  • Parameters:

    • file_id (str) – Unique identifier of the file to update.
    • path (PathLike | str) – Filesystem path or string path to the new file contents.
    • sources (list [**NewSource | str ] | None) – Optional list of sources related to the file. Each item may be a NewSource instance or a string source name.
    • description (str | None) – Optional updated description of the file.
    • version_name (str | None) – Optional user-defined version label for the updated file.
    • external_identifier (str | None) – Optional external system identifier for the file.
    • display_name (str | None) – Optional human-readable name for the file.
  • Return Type: File

update_file_properties()​

Deprecated in 13.1.9. Use update_resource_revision.

Update metadata properties of an existing file.

This method updates non-content attributes of a file, such as display name, description, version name, or external identifier, without modifying the file’s contents.

  • Parameters:

    • file (File) – The file object whose metadata will be updated.
    • display_name (str | None) – Optional human-readable name to assign to the file.
    • description (str | None) – Optional text describing the file.
    • external_identifier (str | None) – Optional external system identifier for cross-referencing the file.
    • version_name (str | None) – Optional user-defined version label for the file.
  • Return Type: File

get_file()​

Deprecated in 13.1.9. Use get_resource.

Gets a file by id.

  • Parameters:

    • file_id (str) – The id of the file to get. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: File

get_file_by_revision_id()​

Deprecated in 13.1.9. Use get_resource_revision. That call also takes the resource id.

Gets a file by revision id.

  • Parameters:

    • revision_id (str) – The revision id of the file to get. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: File

list_files()​

Deprecated in 13.1.9. Use list_resources with type_name=["file"].

Lists all files that a user has access to.

  • Parameters:

    • page (int) – Page number
    • size (int) – Page size
    • filter_by (FilterBy) – Filter results by ownership. One of: created_by_id (created by you), -created_by_id (shared with you).
    • archive_status (ArchiveStatus) – Filter results by archive status. One of: active, archived, all. Default: active.
    • sort (str)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: PageFile

archive_file()​

Deprecated in 13.1.9. Use archive_resource.

Archives a file by updating it’s archive status to Archived.

  • Parameters:

    • file_id (str) – The id of the file to archive. (required)
    • archive (Archive)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: File

restore_file()​

Deprecated in 13.1.9. Use restore_resource.

Restores a file by updating it’s archive status to Active.

  • Parameters:

    • file_id (str) – The id of the file to restore. (required)
    • restore (Restore)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: File

get_file_control_tagging_history()​

Gets the full history of control taggings added to and removed from a file.

  • Parameters:

    • file_id (str) – The ID of the file to get.. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: List[FileControlTagging]

get_file_control_taggings()​

Gets a file’s active control taggings.

  • Parameters:

    • file_id (str) – The ID of the file to get.. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: List[FileControlTagging]

Models​

add_model()​

Deprecated in 13.1.9. Use create_resource with resource_type="model".

Upload a filesystem path as a model: the Resource you share, track in a System, and run jobs on. This is the usual way to upload, and it matches Add resources in the web app.

The returned Model includes its storage File as model.file.

This method optionally attaches metadata, including description, version name, external identifier, display name, and sources.

  • Parameters:

    • path (PathLike) – Filesystem path to the model file to upload.
    • sources (list [**NewSource | str ] | None) – Optional list of sources associated with the model. Each item may be a NewSource instance or a string source name.
    • description (str | None) – Optional text describing the model’s purpose or contents.
    • version_name (str | None) – Optional user-defined version label for the model.
    • external_identifier (str | None) – Optional external system identifier for the model.
    • display_name (str | None) – Optional human-readable name for the model.
  • Return Type: Model

update_model()​

Deprecated in 13.1.9. Use create_resource_revision.

Update an existing model with a new file and optional metadata.

This method replaces the contents of a model by uploading a new file from the specified path. You can also update metadata such as description, version name, external identifier, and sources.

  • Parameters:

    • model_id (str) – Unique identifier of the model to update.
    • path (PathLike) – Filesystem path to the new model file.
    • sources (list [**NewSource | str ] | None) – Optional list of sources associated with the model. Each item may be a NewSource instance or a string source name.
    • description (str | None) – Optional updated description of the model.
    • version_name (str | None) – Optional user-defined version label for the model.
    • external_identifier (str | None) – Optional external system identifier for the model.
    • display_name (str | None) – Optional human-readable name for the model.
  • Return Type: Model

get_model()​

Deprecated in 13.1.9. Use get_resource.

Gets a model by id.

  • Parameters:

    • model_id (str) – The model ID to get.. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: Model

list_models()​

Deprecated in 13.1.9. Use list_resources with type_name=["model"].

Lists all models a user has access to.

  • Parameters:

    • page (int) – Page number
    • size (int) – Page size
    • filter_by (FilterBy) – Filter results by ownership. One of: created_by_id (created by you), -created_by_id (shared with you).
    • archive_status (ArchiveStatus) – Filter results by archive status. One of: active, archived, all. Default: active.
    • sort (str)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: PageModelListItem

archive_model()​

Deprecated in 13.1.9. Use archive_resource.

Archives a model by updating it’s archive status to Archived.

  • Parameters:

    • model_id (str) – The id of the model to archive. (required)
    • archive (Archive)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: Model

restore_model()​

Deprecated in 13.1.9. Use restore_resource.

Restores a model by updating it’s archive status to Active.

  • Parameters:

    • model_id (str) – The id of the model to restore. (required)
    • restore (Restore)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: Model

get_model_control_tagging_history()​

Gets the full history of control taggings added to and removed from a model.

  • Parameters:

    • model_id (str) – The ID of the model to get.. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: List[ResourceControlTagging]

get_model_control_taggings()​

Gets a model’s active control taggings.

  • Parameters:

    • model_id (str) – The ID of the model to get.. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: List[ResourceControlTagging]

Artifacts​

add_artifact()​

Deprecated in 13.1.9. Use create_resource with resource_type="artifact".

Upload a filesystem path and attach an artifact Resource to an existing model (model_id).

The Resources page nests the artifact under that model. The returned Artifact includes its storage File as artifact.file.

Optionally include metadata such as version name, description, external identifier, and source references.

  • Parameters:

    • model_id (str) – Unique identifier of the model to which the artifact will be added.
    • path (PathLike) – Filesystem path to the artifact file to upload.
    • sources (list [**NewSource | str ] | None) – Optional list of sources associated with the artifact. Each item may be a NewSource instance or a string source name.
    • description (str | None) – Optional text describing the artifact’s contents or purpose.
    • version_name (str | None) – Optional user-defined version label for the artifact.
    • external_identifier (str | None) – Optional external system identifier for cross-referencing.
    • display_name (str | None) – Optional human-readable name for the artifact.
  • Return Type: Artifact

add_artifacts_bulk()​

Add multiple artifacts to a model in a single bulk request.

This method uploads several files and registers them as artifacts on the same model. It is more efficient than calling add_artifact in a loop when you have a batch of small files.

Deprecated and unstable

add_artifacts_bulk is deprecated and may be removed in a future release. Prefer add_artifact. The bulk endpoint is also limited to 10 items per call and does not support files larger than the multipart upload threshold.

  • Parameters:

    • model_id (str) – Unique identifier of the model to which the artifacts will be added.
    • revision_create_dtos (list[RevisionBulkCreateItem]) – Up to 10 revision items, each specifying a file path and optional metadata (sources, description, version_name, external_identifier, display_name).
  • Return Type: List[Artifact]

update_artifact()​

Deprecated in 13.1.9. Use create_resource_revision.

Update an existing artifact with a new file and optional metadata.

This method replaces the contents of an existing artifact by uploading a new file and optionally modifying associated metadata such as sources, version, or identifiers.

  • Parameters:

    • artifact_id (str) – Unique identifier of the artifact to update.
    • path (PathLike) – Filesystem path to the new artifact file.
    • sources (list [**NewSource | str ] | None) – Optional list of sources associated with the artifact. Each item may be a NewSource instance or a string source name.
    • description (str | None) – Optional text describing the updated artifact.
    • version_name (str | None) – Optional user-defined version label for the updated artifact.
    • external_identifier (str | None) – Optional external system identifier for cross-referencing.
    • display_name (str | None) – Optional human-readable name for the updated artifact.
  • Return Type: Artifact

get_artifact()​

Deprecated in 13.1.9. Use get_resource.

Gets an artifact from the database.

  • Parameters:

    • artifact_id (str) – The id of the artifact to get.. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: Artifact

list_artifacts()​

Deprecated in 13.1.9. Use list_resources with type_name=["artifact"].

Lists all artifacts a user has access to.

  • Parameters:

    • page (int) – Page number
    • size (int) – Page size
    • filter_by (FilterBy) – Filter artifacts by ownership. One of: created_by_id (created by you), -created_by_id (shared with you).
    • archive_status (ArchiveStatus) – Filter results by archive status. One of: active, archived, all. Default: active.
    • sort (str)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: PageArtifact

list_model_artifacts()​

Deprecated in 13.1.9. Use list_resources with type_name=["artifact"]. That call does not take a parent model id.

Lists all artifacts a user has access to for a model.

  • Parameters:

    • model_id (str) – The id of the model to list artifacts for. (required)
    • page (int) – Page number
    • size (int) – Page size
    • filter_by (FilterBy) – Filter model artifacts by ownership. One of: created_by_id (created by you), -created_by_id (shared with you).
    • archive_status (ArchiveStatus) – Filter results by archive status. One of: active, archived, all. Default: active.
    • sort (str)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: PageArtifact

archive_artifact()​

Deprecated in 13.1.9. Use archive_resource.

Archives an artifact by updating it’s archive status to Archived.

  • Parameters:

    • artifact_id (str) – The id of the artifact to archive.. (required)
    • archive (Archive)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: Artifact

restore_artifact()​

Deprecated in 13.1.9. Use restore_resource.

Restores an artifact by updating it’s archive status to Active.

  • Parameters:

    • artifact_id (str) – The id of the artifact to restore.. (required)
    • restore (Restore)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: Artifact

get_artifact_control_tagging_history()​

Gets the full history of control taggings added to and removed from an artifact.

  • Parameters:

    • artifact_id (str) – The ID of the artifact to get.. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: List[ResourceControlTagging]

get_artifact_control_taggings()​

Gets a artifact’s active control taggings.

  • Parameters:

    • artifact_id (str) – The ID of the artifact to get.. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: List[ResourceControlTagging]

Comments​

add_comment()​

Add a new comment to a resource.

This method uploads a file as a comment and associates it with the specified resource. An optional description can be provided to summarize or contextualize the comment content.

  • Parameters:

    • resource_id (str) – Unique identifier of the resource to which the comment will be added.
    • path (PathLike) – Filesystem path to the comment file to upload.
    • description (str | None) – Optional text describing the comment or its relevance.
  • Return Type: Comment

update_comment()​

Update an existing comment with a new file and optional description.

This method replaces the contents of an existing comment by uploading a new file. An optional description can be provided to revise or clarify the comment’s purpose.

  • Parameters:

    • comment_id (str) – Unique identifier of the comment to update.
    • path (PathLike) – Filesystem path to the new comment file.
    • description (str | None) – Optional updated description of the comment.
  • Return Type: Comment

get_comment()​

Gets a comment by id

  • Parameters:

    • comment_id (str) – The ID of the comment to retrieve. (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: Comment

list_artifact_comments()​

Deprecated in 13.1.9. Use list_comments.

Lists all comments a user has access to for an artifact.

  • Parameters:

    • artifact_id (str) – The id of the artifact to get comments for.. (required)
    • page (int) – Page number
    • size (int) – Page size
    • archive_status (ArchiveStatus) – Filter results by archive status. One of: active, archived, all. Default: active.
    • sort (str)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: PageComment

list_model_comments()​

Deprecated in 13.1.9. Use list_comments.

Lists all comments a user has access to for a model.

  • Parameters:

    • model_id (str) – The model ID to which the comment belongs. (required)
    • page (int) – Page number
    • size (int) – Page size
    • archive_status (ArchiveStatus) – Filter results by archive status. One of: active, archived, all. Default: active.
    • sort (str)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: PageComment

archive_comment()​

Archives a comment by updating it’s archive status to Archived.

  • Parameters:

    • comment_id (str) – The ID of the comment to archive. (required)
    • archive (Archive)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: Comment

restore_comment()​

Restores a comment by updating it’s archive status to Active.

  • Parameters:

    • comment_id (str) – The ID of the comment to restore. (required)
    • restore (Restore)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: Comment

Revisions​

create_revision()​

Create a new file revision from a given file path and optional metadata.

This method uploads a file as a new revision and optionally attaches metadata such as sources, display name, description, version name, and an external identifier.

  • Parameters:

    • file_path (PathLike) – Filesystem path to the file being uploaded as a revision.
    • sources (list [**NewSource | str ] | None) – Optional list of sources associated with the revision. Each item may be a NewSource instance or a string source name.
    • display_name (str | None) – Optional human-readable name for the revision.
    • description (str | None) – Optional text describing the revision’s contents or purpose.
    • version_name (str | None) – Optional user-defined version label for the revision.
    • external_identifier (str | None) – Optional external system identifier for the revision.
  • Return Type: FileRevision

create_revisions_bulk()​

Uploads several files as new revisions in one call. Files larger than the multipart threshold are rejected; upload those with create_revision() one at a time.

create_secret_revision()​

Create a new secret file revision from a given file path and optional metadata.

This method uploads a file containing secret content as a new revision, and optionally associates metadata such as sources, display name, description, version name, and an external identifier.

  • Parameters:

    • file_path (PathLike) – Filesystem path to the secret file being uploaded as a revision.
    • sources (list [**NewSource | str ] | None) – Optional list of sources associated with the revision. Each item may be a NewSource instance or a string source name.
    • display_name (str | None) – Optional human-readable name for the revision.
    • description (str | None) – Optional text describing the revision’s contents or purpose.
    • version_name (str | None) – Optional user-defined version label for the revision.
    • external_identifier (str | None) – Optional external system identifier for the revision.
  • Return Type: FileRevision

update_revision_content()​

Update the contents of an existing file revision.

This method uploads new content from the given file path to update an existing revision. A salt value must be provided to locate or identify the revision being updated. Optional metadata such as sources, display name, description, version name, and external identifier can also be modified.

  • Parameters:

    • file_path (PathLike) – Filesystem path to the new file content for the revision.
    • salt (str) – Unique salt value used to identify or deduplicate the revision update.
    • sources (list [**NewSource | str ] | None) – Optional list of sources associated with the revision. Each item may be a NewSource instance or a string source name.
    • display_name (str | None) – Optional human-readable name for the revision.
    • description (str | None) – Optional text describing the updated revision content.
    • version_name (str | None) – Optional user-defined version label for the revision.
    • external_identifier (str | None) – Optional external system identifier for the revision.
  • Return Type: FileRevision

update_revision_properties()​

Update metadata properties of an existing file revision.

This method modifies the metadata associated with a file revision, such as display name, description, version name, or external identifier. The revision content itself is not changed.

  • Parameters:

    • file_revision (FileRevision) – The file revision object whose metadata will be updated.
    • display_name (str | None) – Optional human-readable name for the revision.
    • description (str | None) – Optional text describing the revision.
    • external_identifier (str | None) – Optional external system identifier for the revision.
    • version_name (str | None) – Optional user-defined version label for the revision.
  • Return Type: File

get_revision()​

Deprecated in 13.1.9. Use get_resource_revision. That call also takes the resource id.

Gets a revision by id.

  • Parameters:

    • revision_id (str) – The id of the revision to get (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: FileRevision

archive_file_revision()​

Deprecated in 13.1.9. V3Client has no call that archives a single revision. archive_resource archives the Resource.

Archives a FileRevision by updating it’s archive status to Archived.

  • Parameters:

    • revision_id (str) – The id of the file revision to archive. (required)
    • archive (Archive)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: FileRevision

restore_file_revision()​

Deprecated in 13.1.9. V3Client has no call that restores a single revision. restore_resource restores the Resource.

Restores a FileRevision by updating it’s archive status to Active.

  • Parameters:

    • revision_id (str) – The id of the file revision to restore. (required)
    • restore (Restore)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: FileRevision

read_contents()​

Read and return the raw contents of a file associated with a token.

This method retrieves the file data as a byte stream using the specified token, which grants access to the protected resource.

  • Parameters: token (Token) – Access token for retrieving the file contents.

  • Return Type: bytes

read_properties()​

Retrieve metadata properties for a file associated with a token.

This method returns descriptive metadata about the file identified by the provided access token. The returned Properties object includes non-content attributes such as file name, extension, size, MIME type, and optional descriptive metadata.

Fields include:

  • name: Full file name with extension (e.g., “foo.JPG”).
  • stem: File name without extension (e.g., “foo”).
  • extension: Lowercased file extension without the dot (e.g., “jpg”).
  • suffix: File suffix with original casing and a leading dot (e.g., “.JPG”).
  • size: File size in bytes.
  • mime_type: MIME type of the file (e.g., “image/jpeg”).
  • description: Optional description set on the file.
  • version_name: Optional version label.
  • external_identifier: Optional external reference ID.
  • display_name: Optional user-facing display name.
  • Parameters: token (Token) – Access token used to retrieve file properties.

  • Return Type: Properties

copy_revision_to_existing_file()​

Deprecated in 13.1.9. V3Client has no copy call.

Copies a revision to an existing file.

  • Parameters:

    • revision_id (str) – The id of the revision to copy (required)
    • file_id (str) – The id of the file to copy the revision to (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: File

copy_revision_to_new_file()​

Deprecated in 13.1.9. V3Client has no copy call.

Copies a revision to a new file.

  • Parameters:

    • revision_id (str) – The id of the revision to copy (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: File

transfer_revision_to_existing_file()​

Deprecated in 13.1.9. V3Client has no transfer call.

Transfers a file revision to an existing file. The original revision that was copied will be archived and no longer active.

  • Parameters:

    • revision_id (str) – The id of the revision to transfer (required)
    • file_id (str) – The id of the file to transfer the revision to (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: File

transfer_revision_to_new_file()​

Deprecated in 13.1.9. V3Client has no transfer call.

Transfers a file revision to a new file. The original revision that was copied will be archived and no longer active.

  • Parameters:

    • revision_id (str) – The id of the revision to transfer (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: File

transfer_revision_to_existing_artifact()​

Deprecated in 13.1.9. V3Client has no transfer call.

Transfers a revision to an existing artifact. The original revision that was copied will be archived and no longer active.

  • Parameters:

    • revision_id (str) – The id of the revision to transfer (required)
    • artifact_id (str) – The id of the artifact to transfer the revision to (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: FileRevision

transfer_revision_to_new_artifact()​

Deprecated in 13.1.9. V3Client has no transfer call.

Transfers a revision to a new artifact. The original revision that was copied will be archived and no longer active.

  • Parameters:

    • revision_id (str) – The id of the revision to transfer (required)
    • model_id (str) – The id of the model to transfer the revision to (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: FileRevision

get_resource()​

Deprecated in 13.1.9 for a model, artifact, or file: this method calls the deprecated getters. Use get_resource.

Retrieve a resource by type and ID.

This method fetches a resource of the specified type using its unique identifier. It dispatches to the appropriate get_* method based on the resource type.

  • Parameters:

    • resource_type (str) – Type of the resource to retrieve. Must be one of: Artifact, Comment, Model, Job, FunctionAuthSecretEntity. (required)
    • resource_id (str) – Unique identifier of the resource. (required)
  • Return Type: Artifact | Comment | Model | Job | FunctionAuthSecret

  • Raises: TypeError if resource_type is not one of the supported values.

list_resources()​

Deprecated in 13.1.9. Use list_resources.

Lists all resources a user has access to.

  • Parameters:

    • page (int) – Page number
    • size (int) – Page size
    • id (List [**Optional [**str ] ]) – A list of resource IDs to filter on
    • file_name (List [**Optional [**str ] ]) – A list of file names to filter on (single value performs a like comparison)
    • type_name (List [**ResourceType ]) – A list of resource types to filter on. Values: model, artifact, comment, job, document, resource.
    • description (List [**str ]) – A list of file descriptions to filter on (single value performs a like comparison)
    • version_name (List [**str ]) – A list of file version names to filter on (single value performs a like comparison)
    • external_identifier (List [**str ]) – A list of file external identifiers to filter on (single value performs a like comparison)
    • display_name (List [**str ]) – A list of file display names to filter on (single value performs a like comparison)
    • mime_type (List [**str ]) – A list of file mime types to filter on
    • file_size (List [**int ]) – A list of file sizes to filter on
    • created_timestamp (List [**Optional [**datetime ] ]) – A list of file creation timestamps to filter on
    • updated_timestamp (List [**datetime ]) – A list of file update timestamps to filter on
    • created_by_id (List [**str ]) – A list of user IDs that created the file to filter on
    • updated_by_id (List [**str ]) – A list of user IDs that updated the file to filter on
    • archive_status (List [**ArchiveStatusName ]) – A list of archive statuses to filter on. Values: Archived, Active.
    • access_type (BulkSharingAccessRelation) – Filter resources by access type. One of: viewer, editor.
    • sort (str)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: PageResourceSearchItem

search_resources()​

Deprecated in 13.1.9. Use search.

Performs a full-text search across resources.

  • Parameters:

    • full_text_search (FullTextSearch) – The search query. The search_term field must be at least 1 character. page must be at least 1; size must be between 1 and 100 (defaults: page 1, size 10). (required)
    • http_request_timeout_secs (int , optional) – timeout setting for this request
  • Return Type: PageTypeVarCustomizedResourceSearchItem