Client

The Client class is the main entry point for the Istari Digital Platform Python SDK. It provides methods for managing files, models, artifacts, jobs, access control, systems, agents, and more.

The SDK is shipped as the istari-digital-client package on PyPI. Supported Python versions for the client are listed on the PyPI project description.

from istari_digital_client import Client, Configuration

client = Client(Configuration(
    registry_url="https://your-instance.istari.digital",
    registry_auth_token="your-personal-access-token",
))

See Setup for installation and configuration details.

Pagination

Most list_* methods support pagination via page and size parameters:

• page (int) – Page number. Minimum: 1. Default: 1.
• size (int) – Number of items per page. Range: 0–100. Default: 10.

Common fields

Several methods accept the same optional metadata fields:

Field	Type	Description
display_name	str | None	Human-readable name
description	str | None	Text describing the resource
version_name	str | None	User-defined version label
external_identifier	str | None	External system identifier for cross-referencing
sources	list[NewSource | str] | None	Associated source references

String constraints (SDK and platform)

The Python SDK validates some fields from the bundled OpenAPI schema. The Istari Digital Platform registry service also persists data with stricter limits than the client always checks locally.

• File revision metadata (description, display_name, version_name, external_identifier on uploads such as add_file, add_model, add_artifact, and create_revision): In the registry database these are stored as 255-character columns on the file_revision row (same length class as mime, name, and extension). The bundled FileRevision OpenAPI schema may omit maxLength, and the client does not apply Pydantic max_length for these fields, but values longer than 255 characters are not storable and should be treated as invalid for practical use.
• Control tags (create_control_tag / update_control_tag): Optional description on NewControlTag and UpdateControlTag is validated as 0–255 characters on the platform (and in the OpenAPI schema). See Access control.
• Full-text search (search_resources): FullTextSearch on the platform requires search_term to be at least 1 character, page at least 1, and size between 1 and 100 (defaults page 1, size 10). See search_resources.

Method reference

Methods are grouped by domain. Each page is self-contained with full parameter details.

Files, models & artifacts

Upload, version, and manage the core data types.

Method	Description
add_file / add_model / add_artifact	Upload a new file, model, or artifact
update_file / update_model / update_artifact	Replace contents with a new version
get_file / get_model / get_artifact	Retrieve by ID
list_files / list_models / list_artifacts	List with pagination and filters
create_revision / update_revision_content	Manage file revisions
read_contents / read_properties	Read file data and metadata
get_resource / list_resources / search_resources	Cross-type lookup and search
archive_* / restore_*	Archive or restore any resource

Jobs

Create and monitor function execution.

Method	Description
add_job	Create a new job on a model
get_job / list_jobs / list_model_jobs	Retrieve and filter jobs
update_job_status	Transition a job to a new status
update_job_assigned_agent	Assign an agent to a job

Systems & snapshots

Manage systems, configurations, and point-in-time snapshots.

Method	Description
create_system / get_system / list_systems	Manage systems
create_configuration / list_system_configurations	System configurations
create_snapshot / list_snapshots	Create and browse snapshots
create_tag / update_tag / list_tags	Label snapshots with tags

Access control

Share resources and manage control tags.

Method	Description
create_access / update_access / remove_access	Grant, modify, or revoke access
bulk_create_access	Share multiple resources at once
create_control_tag / update_control_tag	Create and manage control tags
add_*_control_taggings / remove_*_control_taggings	Assign or revoke tags on resources
list_resource_type_permissions	Query permissions across resources

Agents, modules & tools

Register agents, manage pools, and work with modules and functions.

Method	Description
register_agent / get_agent / list_agents	Agent lifecycle
create_agent_pool / update_agent_pool	Manage agent pools
create_module / get_module / list_modules	Module management
get_function / list_functions	Query available functions
create_tool / list_tools	Tool and version management

Users, tokens & admin

Manage users, authentication, and platform operations.

Method	Description
get_current_user / list_users	User lookup
create_personal_access_token / revoke_all_personal_access_tokens	Token management
create_app_integration / create_auth_integration	Integration setup
generate_upload_url / generate_download_url	Temporary storage URLs
liveness_check / readiness_check	Health probes

Enums

Reference tables for all enum types: JobStatusName, ArchiveStatus, AccessRelation, OS, FunctionAuthType, and more.

Data types

Structured types returned by client methods and accepted as parameters. Each page groups related types by domain, matching the method pages above.

Page	Contents
Files, models & artifacts	File, Model, Artifact, FileRevision, Comment, NewSource, and pagination wrappers
Jobs	Job, JobStatus, JobStatusName, JobStatusMessage
Systems & snapshots	System, Snapshot, SnapshotTag, SystemConfiguration, UpstreamRemote
Access control	Permission, AccessRelationship, ControlTag, SubjectInfo
Agents & modules	Agent, AgentPool, Module, Function, Tool, and related input/status types
Users, tokens & admin	User, Token, Tenant, AppIntegration, AuthIntegration
Common types	Archive, Restore, Pageable, FilterBy, PatchOp, and validation types