Skip to main content
Version: 2026.03

Common types

Shared data types used across the SDK: archiving, pagination, filtering, and validation.

info

All data types support standard serialization methods (to_json, from_json, to_dict, from_dict, to_str) which are omitted from the tables below.

Archive

Attributes:

NameTypeDescription
reasonstr

ArchiveStatus

Enum for archive status.

Attributes:

NameTypeDescription
ARCHIVED
ACTIVE
ALL

ArchiveStatusName

Attributes:

NameTypeDescription
ARCHIVED
ACTIVE

ResourceArchiveStatus

Attributes:

NameTypeDescription
idstr
createddatetime.datetime
nameArchiveStatusName
reasonOptional[str]
created_by_idOptional[str]
resource_idstr

Restore

Attributes:

NameTypeDescription
reasonstr

Pageable

A generic paginated response model for handling lists of items.

Attributes:

NameTypeDescription
itemsList[T]
totalOptional[int]
pageOptional[int]
sizeOptional[int]
pagesOptional[int]

Methods:

NameDescription
iter_pagesIterate over all pages using the configured list method.
iter_itemsIterate over all items across all pages.

FilterBy

Enum for filtering entities based on different criteria.

Attributes:

NameTypeDescription
MINUS_CREATED_BY_ID
CREATED_BY_ID

PatchOp

Attributes:

NameTypeDescription
SET
DELETE

Readable

Abstract base class for objects that expose readable file-like content.

Methods:

NameDescription
read_bytesRead the contents as raw bytes.
read_textRead the contents as decoded text.
copy_toCopy the contents to a local file.
read_jsonParse the contents as JSON.
cleanup_cacheClean up cached files if they exist.
get_cache_statsGet filesystem cache statistics.

Shareable

Helper class that provides a standard way to create an ABC using

Methods:

NameDescription
create_accessCreate a new access relationship for a subject by ID.
create_access_by_emailCreate a new access relationship for a subject by email.
update_accessUpdate an existing access relationship for a subject.
remove_accessRemove an existing access relationship.
list_accessList all access relationships for this resource.

Archivable

Abstract mixin class for archivable and restorable resources.

Methods:

NameDescription
archiveArchive the current item using the client’s archive method for this resource type.
restoreRestore the current item using the client’s restore method for this resource type.

ClientHaving

Mixin for models that require access to a ClientApi instance.

ResourceType

Enum for resource types.

Attributes:

NameTypeDescription
MODEL
ARTIFACT
COMMENT
JOB

UsabilityStatusName

Attributes:

NameTypeDescription
SUPPORTED
DEPRECATED

UsabilityStatusParams

Attributes:

NameTypeDescription
SUPPORTED
DEPRECATED
ALL

TemporaryURL

Data transfer object for holding signed temporary urls and their expiry date times.

Attributes:

NameTypeDescription
urlstr
expiresOptional[datetime.datetime]

HTTPValidationError

Attributes:

NameTypeDescription
detailOptional[List[ValidationError]]

ValidationError

Attributes:

NameTypeDescription
locList[ValidationErrorLocInner]
msgstr
typestr

ValidationErrorLocInner

Attributes:

NameTypeDescription
anyof_schema_1_validatorOptional[str]
anyof_schema_2_validatorOptional[int]
actual_instanceOptional[Union[int, str]]
any_of_schemasSet[str]

Methods:

NameDescription
actual_instance_must_validate_anyof

UserModelInputs

Attributes:

NameTypeDescription
SINGLE
MULTIPLE