Class TwinClient

Implements

ITwinClient

Index

Constructors

Accessors

Methods

batchAssets batchGetAssets createAssetAttachmentUploadSession createAssets createOrUpdateTwin createOrUpdateTwinFile createOrUpdateTwinFileRaw createOrUpdateTwinRaw deleteAsset deleteAssetAttachment deleteAssetCategory deleteAssetType deleteTwin deleteTwinFile downloadTwinContent getAsset getAssetAttachmentBlob getAssetAttachmentUploadStatus getAssetCategory getAssetType getAssetTypeCatalog getAssetTypeMetaSchema getMyPermissions getProcessorEvents getTwin getTwinContent getTwinDiagnostics getTwinFile getTwinFileContent getTwinFileVersion getTwinFileVersionContent getTwinVersionContent getTwinVersionDiagnostics getTwinVersionEvents listAllTwins listAssetAttachments listAssetCategories listAssetCategoryVersions listAssets listAssetTypes listAssetTypeVersions listTwinFiles listTwinFileVersions listTwins listTwinVersions loadGeometryInfo loadGeometryInfoWithFactories loadTwin loadTwinWithFactories loadTwinWithGeometry putAssetAttachment putAssetCategory putAssetType restoreAsset restoreAssetAttachment restoreAssetCategory restoreAssetType restoreTwin restoreTwinFile updateAsset updateTwin uploadAssetAttachmentFile

Constructors

constructor

new TwinClient(
baseUrl: string | URL,
_httpClient: TwinfinityHttpClient,
): TwinClient
Parameters
- baseUrl: string | URL
- _httpClient: TwinfinityHttpClient
Returns TwinClient

Accessors

baseUrl

get baseUrl(): string
Rooted twins base URL — typically <host>/sites/<container>/_ps/twins. Exposed so callers that want to build content URLs in the same auth scope as the metadata calls can derive them from here. The bare <host>/_ps/twins/... variant is not necessarily an authorized route on all deployments.

Returns string
Implementation of ITwinClient.baseUrl

Methods

batchAssets

batchAssets(
    twinId: string,
    operations: AssetBatchOperation[],
    signal?: AbortSignal,
): Promise<AssetBatchResponse>
Executes a batch of asset operations (upsert, delete, restore) atomically. All operations succeed or all are rolled back.
Parameters
- twinId: string
- operations: AssetBatchOperation[]
  Array of batch operations (max 1000).
- Optionalsignal: AbortSignal
Returns Promise<AssetBatchResponse>
Throws
On validation failure (400).

Throws
On insufficient permissions (403).

Throws
On conflict (409) or not found (404). The error's response has per-item results with reverted statuses.

Implementation of ITwinClient.batchAssets

batchGetAssets

batchGetAssets(
    twinId: string,
    ids: string[],
    signal?: AbortSignal,
): Promise<AssetBatchGetResponse>
Retrieves multiple assets by ID in a single request.
Parameters
- twinId: string
- ids: string[]
  Array of asset IDs (max 1000).
- Optionalsignal: AbortSignal
Returns Promise<AssetBatchGetResponse>
Throws
On validation failure (400).

Implementation of ITwinClient.batchGetAssets

createAssetAttachmentUploadSession

createAssetAttachmentUploadSession(
    twinId: string,
    assetId: string,
    attachmentId: string,
    body: AttachmentPost,
    signal?: AbortSignal,
): Promise<ApiCreateUploadSessionResponse>
Creates an upload session for a new attachment. The actual file bytes are uploaded out-of-band to ApiCreateUploadSessionResponse.uploadUrl; use uploadAssetAttachmentFile for the canonical chunked-upload flow. The attachment row is materialized server-side when the blob lands.
Parameters
- twinId: string
- assetId: string
- attachmentId: string
- body: AttachmentPost
- Optionalsignal: AbortSignal
Returns Promise<ApiCreateUploadSessionResponse>
Throws
When an attachment already exists for the given id (409); retries must use a new attachmentId.

Implementation of ITwinClient.createAssetAttachmentUploadSession

createAssets

createAssets(
    twinId: string,
    assets: AssetPost[],
    signal?: AbortSignal,
): Promise<AssetGet[]>
Parameters
- twinId: string
- assets: AssetPost[]
- Optionalsignal: AbortSignal
Returns Promise<AssetGet[]>
Throws
On invalid request body (400). The error's errorBody has structured detail.

Implementation of ITwinClient.createAssets

createOrUpdateTwin

createOrUpdateTwin(
    twinId: string,
    twin: TwinPut,
    signal?: AbortSignal,
): Promise<TwinGet>
Creates a new twin or updates an existing one (upsert). Provide etag in the twin body to update.
Parameters
- twinId: string
- twin: TwinPut
- Optionalsignal: AbortSignal
Returns Promise<TwinGet>
Throws
On invalid request body (400).

Throws
On etag mismatch (409). The error's currentTwin contains the server's current state.

Implementation of ITwinClient.createOrUpdateTwin

createOrUpdateTwinFile

createOrUpdateTwinFile(
    twinId: string,
    fileId: string,
    twinFile: TwinFilePut,
    signal?: AbortSignal,
): Promise<TwinFileGet>
Parameters
- twinId: string
- fileId: string
- twinFile: TwinFilePut
- Optionalsignal: AbortSignal
Returns Promise<TwinFileGet>
Throws
On invalid request body (400).

Throws
On etag mismatch (409). The error's currentTwinFile contains the server's current state.

Implementation of ITwinClient.createOrUpdateTwinFile

createOrUpdateTwinFileRaw

createOrUpdateTwinFileRaw(
    twinId: string,
    fileId: string,
    twinFile: unknown,
    signal?: AbortSignal,
): Promise<Response>
Parameters
- twinId: string
- fileId: string
- twinFile: unknown
- Optionalsignal: AbortSignal
Returns Promise<Response>

createOrUpdateTwinRaw

createOrUpdateTwinRaw(
    twinId: string,
    twin: unknown,
    signal?: AbortSignal,
): Promise<Response>
Parameters
- twinId: string
- twin: unknown
- Optionalsignal: AbortSignal
Returns Promise<Response>

deleteAsset

deleteAsset(
    twinId: string,
    assetId: string,
    etag: string,
    signal?: AbortSignal,
): Promise<AssetGet>
Parameters
- twinId: string
- assetId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<AssetGet>
Throws
When the asset does not exist (404).

Throws
On etag mismatch (409). The error's currentAsset contains the server's current state.

Implementation of ITwinClient.deleteAsset

deleteAssetAttachment

deleteAssetAttachment(
    twinId: string,
    assetId: string,
    attachmentId: string,
    etag: string,
    signal?: AbortSignal,
): Promise<AttachmentGet>
Soft-deletes an attachment.
Parameters
- twinId: string
- assetId: string
- attachmentId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<AttachmentGet>
Throws
On etag mismatch (409).

Throws
When the attachment does not exist (404).

Implementation of ITwinClient.deleteAssetAttachment

deleteAssetCategory

deleteAssetCategory(
    categoryId: string,
    etag: string,
    signal?: AbortSignal,
): Promise<AssetCategoryGet>
Soft-deletes a category. Inserts a new asset_category_versions row with is_deleted=true; the previous version is retained as an audit trail.
Parameters
- categoryId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<AssetCategoryGet>
Throws
When the category does not exist (404).

Throws
On etag mismatch (409).

Implementation of ITwinClient.deleteAssetCategory

deleteAssetType

deleteAssetType(
    categoryId: string,
    typeId: string,
    etag: string,
    signal?: AbortSignal,
): Promise<AssetTypeGet>
Soft-deletes a type. Inserts a new asset_type_versions row with is_deleted=true; the previous version is retained as an audit trail.
Parameters
- categoryId: string
- typeId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<AssetTypeGet>
Throws
When the type does not exist (404).

Throws
On etag mismatch (409).

Implementation of ITwinClient.deleteAssetType

deleteTwin

deleteTwin(twinId: string, etag: string, signal?: AbortSignal): Promise<TwinGet>
Parameters
- twinId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<TwinGet>
Throws
When the twin does not exist (404).

Throws
On etag mismatch (409). The error's currentTwin contains the server's current state.

Implementation of ITwinClient.deleteTwin

deleteTwinFile

deleteTwinFile(
    twinId: string,
    fileId: string,
    deleteRequest: TwinFileDelete,
    signal?: AbortSignal,
): Promise<TwinFileGet>
Parameters
- twinId: string
- fileId: string
- deleteRequest: TwinFileDelete
- Optionalsignal: AbortSignal
Returns Promise<TwinFileGet>
Throws
When the file does not exist (404).

Throws
On etag mismatch (409). The error's currentTwinFile contains the server's current state.

Throws
On invalid request (400).

Implementation of ITwinClient.deleteTwinFile

downloadTwinContent

downloadTwinContent(
    twinId: string,
    twinVersion: number,
    content: TwinContentResponse,
    signal?: AbortSignal,
): Promise<ArrayBuffer>
Parameters
- twinId: string
- twinVersion: number
- content: TwinContentResponse
- Optionalsignal: AbortSignal
Returns Promise<ArrayBuffer>
Implementation of ITwinClient.downloadTwinContent

getAsset

getAsset(
    twinId: string,
    assetId: string,
    signal?: AbortSignal,
): Promise<AssetGet>
Parameters
- twinId: string
- assetId: string
- Optionalsignal: AbortSignal
Returns Promise<AssetGet>
Throws
When the asset does not exist (404).

Implementation of ITwinClient.getAsset

getAssetAttachmentBlob

getAssetAttachmentBlob(
    twinId: string,
    assetId: string,
    attachmentId: string,
    signal?: AbortSignal,
): Promise<Response>
Downloads an attachment's blob as a Response. The caller decides whether to consume it as text, ArrayBuffer, or Blob.
Parameters
- twinId: string
- assetId: string
- attachmentId: string
- Optionalsignal: AbortSignal
Returns Promise<Response>
Throws
When the attachment does not exist (404).

Implementation of ITwinClient.getAssetAttachmentBlob

getAssetAttachmentUploadStatus

getAssetAttachmentUploadStatus(
    twinId: string,
    assetId: string,
    token: string,
    signal?: AbortSignal,
): Promise<UploadStatusGet>
Polls the in-memory upload-session cache for an attachment that's being uploaded.
Parameters
- twinId: string
- assetId: string
- token: string
- Optionalsignal: AbortSignal
Returns Promise<UploadStatusGet>
Implementation of ITwinClient.getAssetAttachmentUploadStatus

getAssetCategory

getAssetCategory(
categoryId: string,
signal?: AbortSignal,
): Promise<AssetCategoryGet>
Parameters
- categoryId: string
- Optionalsignal: AbortSignal
Returns Promise<AssetCategoryGet>
Throws
When the category does not exist (404).

Implementation of ITwinClient.getAssetCategory

getAssetType

getAssetType(
    categoryId: string,
    typeId: string,
    signal?: AbortSignal,
): Promise<AssetTypeGet>
Parameters
- categoryId: string
- typeId: string
- Optionalsignal: AbortSignal
Returns Promise<AssetTypeGet>
Throws
When the category or type does not exist (404).

Implementation of ITwinClient.getAssetType

getAssetTypeCatalog

getAssetTypeCatalog(signal?: AbortSignal): Promise<AssetCatalogResponse>
Returns the customer's asset-type catalog: categories nested with their latest non-deleted types and full metadata schemas inline. One round-trip is enough to populate a picker dropdown and render any per-type metadata form.
Parameters
- Optionalsignal: AbortSignal
Returns Promise<AssetCatalogResponse>
Implementation of ITwinClient.getAssetTypeCatalog

getAssetTypeMetaSchema

getAssetTypeMetaSchema(signal?: AbortSignal): Promise<Record<string, unknown>>
Returns the Twinfinity meta-schema document — the JSON Schema describing valid asset-type metadata schemas. The bytes the backend itself validates against, served verbatim. Power-user tools (Monaco-backed JSON editors, schema-aware tooling) fetch this at runtime so their in-editor diagnostics line up with what the server will accept, decoupled from the FE bundle's build time.
Parameters
- Optionalsignal: AbortSignal
Returns Promise<Record<string, unknown>>
Implementation of ITwinClient.getAssetTypeMetaSchema

getMyPermissions

getMyPermissions(signal?: AbortSignal): Promise<MyPermissions>
Returns the caller's named, customer-scoped capabilities against the Twin service (e.g. ViewAssetTypes, EditAssetTypes). The admin app uses this to enable or disable buttons instead of letting the user click through to a 403.

No client-side cache — every call hits the wire. Underlying scope grants don't shift within a session, so callers are expected to memoise the result themselves (e.g. via React Query / a once-on-mount fetch) rather than calling this on every render.

Throws TwinUnauthenticatedError on 401 (no valid auth context; caller should redirect to login). Returns an empty permissions array on 403 (authenticated but no Twin-service capabilities). Unknown capability strings should be ignored — adding a new capability is a non-breaking change.
Parameters
- Optionalsignal: AbortSignal
Returns Promise<MyPermissions>
Implementation of ITwinClient.getMyPermissions

getProcessorEvents

getProcessorEvents(
    twinId: string,
    twinVersion: number,
    processorId: string,
    offset?: number,
    limit?: number,
    signal?: AbortSignal,
): Promise<PaginatedResponse<TwinProcessorEvent>>
Parameters
- twinId: string
- twinVersion: number
- processorId: string
- Optionaloffset: number
- Optionallimit: number
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<TwinProcessorEvent>>
Throws
On invalid query parameters (400).

Throws
When the processor does not exist for this twin version (404).

Implementation of ITwinClient.getProcessorEvents

getTwin

getTwin(
twin: string | { id: string; version: number },
signal?: AbortSignal,
): Promise<TwinGet>
Parameters
- twin: string | { id: string; version: number }
  Twin ID string, or {id, version} to fetch a specific version.
- Optionalsignal: AbortSignal
Returns Promise<TwinGet>
Throws
When the twin or version does not exist (404).

Implementation of ITwinClient.getTwin

getTwinContent

getTwinContent(
twinId: string,
signal?: AbortSignal,
): Promise<TwinVersionContentResponse>
Returns content for the latest twin version.
Parameters
- twinId: string
- Optionalsignal: AbortSignal
Returns Promise<TwinVersionContentResponse>
Throws
When the twin does not exist (404).

Implementation of ITwinClient.getTwinContent

getTwinDiagnostics

getTwinDiagnostics(
twinId: string,
signal?: AbortSignal,
): Promise<TwinDiagnosticsResponse>
Parameters
- twinId: string
- Optionalsignal: AbortSignal
Returns Promise<TwinDiagnosticsResponse>
Throws
When the twin does not exist (404).

Implementation of ITwinClient.getTwinDiagnostics

getTwinFile

getTwinFile(
    twinId: string,
    fileId: string,
    signal?: AbortSignal,
): Promise<TwinFileGet>
Parameters
- twinId: string
- fileId: string
- Optionalsignal: AbortSignal
Returns Promise<TwinFileGet>
Throws
When the file does not exist (404).

Throws
On invalid request (400).

Implementation of ITwinClient.getTwinFile

getTwinFileContent

getTwinFileContent(
    twinId: string,
    fileId: string,
    signal?: AbortSignal,
): Promise<Blob>
Parameters
- twinId: string
- fileId: string
- Optionalsignal: AbortSignal
Returns Promise<Blob>
Throws
When the file does not exist (404).

Implementation of ITwinClient.getTwinFileContent

getTwinFileVersion

getTwinFileVersion(
    twinId: string,
    fileId: string,
    version: number,
    signal?: AbortSignal,
): Promise<TwinFileGet>
Parameters
- twinId: string
- fileId: string
- version: number
- Optionalsignal: AbortSignal
Returns Promise<TwinFileGet>
Throws
When the file or version does not exist (404).

Implementation of ITwinClient.getTwinFileVersion

getTwinFileVersionContent

getTwinFileVersionContent(
    twinId: string,
    fileId: string,
    version: number,
    signal?: AbortSignal,
): Promise<Blob>
Parameters
- twinId: string
- fileId: string
- version: number
- Optionalsignal: AbortSignal
Returns Promise<Blob>
Throws
When the file or version does not exist (404).

Implementation of ITwinClient.getTwinFileVersionContent

getTwinVersionContent

getTwinVersionContent(
    twinId: string,
    twinVersion: number,
    signal?: AbortSignal,
): Promise<TwinVersionContentResponse>
Parameters
- twinId: string
- twinVersion: number
- Optionalsignal: AbortSignal
Returns Promise<TwinVersionContentResponse>
Throws
When the twin or version does not exist (404).

Implementation of ITwinClient.getTwinVersionContent

getTwinVersionDiagnostics

getTwinVersionDiagnostics(
    twinId: string,
    twinVersion: number,
    signal?: AbortSignal,
): Promise<TwinDiagnosticsResponse>
Parameters
- twinId: string
- twinVersion: number
- Optionalsignal: AbortSignal
Returns Promise<TwinDiagnosticsResponse>
Throws
When the twin or version does not exist (404).

Implementation of ITwinClient.getTwinVersionDiagnostics

getTwinVersionEvents

getTwinVersionEvents(
    twinId: string,
    twinVersion: number,
    offset?: number,
    limit?: number,
    signal?: AbortSignal,
): Promise<PaginatedResponse<TwinProcessorEvent>>
Parameters
- twinId: string
- twinVersion: number
- Optionaloffset: number
- Optionallimit: number
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<TwinProcessorEvent>>
Throws
On invalid query parameters (400).

Throws
When the twin or version does not exist (404).

Implementation of ITwinClient.getTwinVersionEvents

listAllTwins

listAllTwins(relatedTo?: string, signal?: AbortSignal): Promise<ListTwinItem[]>
Fetches all twins by auto-paginating through listTwins. Caps at 1000 pages.
Parameters
- OptionalrelatedTo: string
  Filter twins by container ID.
- Optionalsignal: AbortSignal
Returns Promise<ListTwinItem[]>
Implementation of ITwinClient.listAllTwins

listAssetAttachments

listAssetAttachments(
    twinId: string,
    assetId: string,
    options?: {
        includeDeleted?: boolean;
        limit?: number;
        offset?: number;
        page?: string;
    },
    signal?: AbortSignal,
): Promise<PaginatedResponse<AttachmentGet>>
Lists attachments for a single asset.
Parameters
- twinId: string
- assetId: string
- Optionaloptions: { includeDeleted?: boolean; limit?: number; offset?: number; page?: string }
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<AttachmentGet>>
Implementation of ITwinClient.listAssetAttachments

listAssetCategories

listAssetCategories(
options?: { includeDeleted?: boolean; limit?: number; page?: string },
signal?: AbortSignal,
): Promise<PaginatedResponse<AssetCategoryGet>>
Parameters
- Optionaloptions: { includeDeleted?: boolean; limit?: number; page?: string }
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<AssetCategoryGet>>
Throws
On invalid query parameters (400).

Implementation of ITwinClient.listAssetCategories

listAssetCategoryVersions

listAssetCategoryVersions(
    categoryId: string,
    options?: { includeDeleted?: boolean; limit?: number; page?: string },
    signal?: AbortSignal,
): Promise<PaginatedResponse<AssetCategoryGet>>
Returns every version of a single asset category, newest first. Mirrors listAssetTypeVersions and twin.get_twin_versions.
Parameters
- categoryId: string
- Optionaloptions: { includeDeleted?: boolean; limit?: number; page?: string }
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<AssetCategoryGet>>
Throws
When the category's header row does not exist (404).

Implementation of ITwinClient.listAssetCategoryVersions

listAssets

listAssets(
    twinId: string,
    offset?: number,
    limit?: number,
    options?: { includeDeleted?: boolean },
    signal?: AbortSignal,
): Promise<PaginatedResponse<AssetListItem>>
Parameters
- twinId: string
- Optionaloffset: number
- Optionallimit: number
- Optionaloptions: { includeDeleted?: boolean }
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<AssetListItem>>
Throws
On invalid query parameters (400).

Throws
When the twin does not exist (404).

Implementation of ITwinClient.listAssets

listAssetTypes

listAssetTypes(
    categoryId: string,
    options?: { includeDeleted?: boolean; limit?: number; page?: string },
    signal?: AbortSignal,
): Promise<PaginatedResponse<AssetTypeGet>>
Parameters
- categoryId: string
- Optionaloptions: { includeDeleted?: boolean; limit?: number; page?: string }
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<AssetTypeGet>>
Throws
On invalid query parameters (400).

Implementation of ITwinClient.listAssetTypes

listAssetTypeVersions

listAssetTypeVersions(
    categoryId: string,
    typeId: string,
    options?: { includeDeleted?: boolean; limit?: number; page?: string },
    signal?: AbortSignal,
): Promise<PaginatedResponse<AssetTypeGet>>
Returns every version of a single asset type, newest first. Mirrors twin.get_twin_versions.
Parameters
- categoryId: string
- typeId: string
- Optionaloptions: { includeDeleted?: boolean; limit?: number; page?: string }
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<AssetTypeGet>>
Throws
When the type's header row does not exist (404).

Implementation of ITwinClient.listAssetTypeVersions

listTwinFiles

listTwinFiles(
    twinId: string,
    options?: TwinFileListOptions,
    signal?: AbortSignal,
): Promise<PaginatedResponse<TwinFileGet>>
Parameters
- twinId: string
- Optionaloptions: TwinFileListOptions
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<TwinFileGet>>
Throws
On invalid query parameters (400).

Implementation of ITwinClient.listTwinFiles

listTwinFileVersions

listTwinFileVersions(
    twinId: string,
    fileId: string,
    options?: TwinFileVersionListOptions,
    signal?: AbortSignal,
): Promise<PaginatedResponse<TwinFileGet>>
Parameters
- twinId: string
- fileId: string
- Optionaloptions: TwinFileVersionListOptions
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<TwinFileGet>>
Throws
On invalid query parameters (400).

Implementation of ITwinClient.listTwinFileVersions

listTwins

listTwins(
    relatedTo?: string,
    page?: string,
    limit?: number,
    signal?: AbortSignal,
): Promise<PaginatedResponse<ListTwinItem>>
Parameters
- OptionalrelatedTo: string
  Filter twins by container ID.
- Optionalpage: string
- Optionallimit: number
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<ListTwinItem>>
Throws
On invalid query parameters (400).

Implementation of ITwinClient.listTwins

listTwinVersions

listTwinVersions(
    id: string,
    options?: {
        includeDeleted?: boolean;
        limit?: number;
        page: undefined | string;
    },
    signal?: AbortSignal,
): Promise<PaginatedResponse<ListTwinItem>>
Parameters
- id: string
- Optionaloptions: { includeDeleted?: boolean; limit?: number; page: undefined | string }
- Optionalsignal: AbortSignal
Returns Promise<PaginatedResponse<ListTwinItem>>
Throws
On invalid query parameters (400).

Implementation of ITwinClient.listTwinVersions

loadGeometryInfo

loadGeometryInfo(
twin: string | { id: string; version: number },
signal?: AbortSignal,
): Promise<TwinGeometryInfo<T8GIMeshDescriptor, T8GIStyle, T8GIRegion>>
Downloads and deserializes geometry info (t8gi) using default types. When no version is specified, searches versions newest-first for one containing t8gi content.
Parameters
- twin: string | { id: string; version: number }
  Twin ID string, or {id, version} to load a specific version.
- Optionalsignal: AbortSignal
Returns Promise<TwinGeometryInfo<T8GIMeshDescriptor, T8GIStyle, T8GIRegion>>
Throws
When no version has t8gi content.

Implementation of ITwinClient.loadGeometryInfo

loadGeometryInfoWithFactories

loadGeometryInfoWithFactories<TMeshDescriptor, TStyle, TRegion>(
    twin: string | { id: string; version: number },
    meshDescriptorFactory: (dto: T8GIMeshDescriptorDTO) => TMeshDescriptor,
    styleFactory: (dto: T8GIStyleDTO) => TStyle,
    regionFactory: (dto: T8GIRegionDTO) => TRegion,
    signal?: AbortSignal,
): Promise<TwinGeometryInfo<TMeshDescriptor, TStyle, TRegion>>
Downloads and deserializes geometry info (t8gi) using custom factory functions. When no version is specified, searches versions newest-first for one containing t8gi content.
Type Parameters
- TMeshDescriptor
- TStyle
- TRegion
Parameters
- twin: string | { id: string; version: number }
  Twin ID string, or {id, version} to load a specific version.
- meshDescriptorFactory: (dto: T8GIMeshDescriptorDTO) => TMeshDescriptor
- styleFactory: (dto: T8GIStyleDTO) => TStyle
- regionFactory: (dto: T8GIRegionDTO) => TRegion
- Optionalsignal: AbortSignal
Returns Promise<TwinGeometryInfo<TMeshDescriptor, TStyle, TRegion>>
Throws
When no version has t8gi content.

Implementation of ITwinClient.loadGeometryInfoWithFactories

loadTwin

loadTwin(
    twin: string | { id: string; version: number },
    signal?: AbortSignal,
): Promise<
    Twin<
        T8Project<T8Product<T8EntityType<T8Unit>, T8Unit>, T8Unit>,
        T8Product<T8EntityType<T8Unit>, T8Unit>,
        T8EntityType<T8Unit>,
        T8Unit,
    >,
>
Downloads and deserializes the T8 client model (t8cm + t8cm-ext) using default types. When no version is specified, searches versions newest-first for one containing t8cm content.
Parameters
- twin: string | { id: string; version: number }
  Twin ID string, or {id, version} to load a specific version.
- Optionalsignal: AbortSignal
Returns Promise<
    Twin<
        T8Project<T8Product<T8EntityType<T8Unit>, T8Unit>, T8Unit>,
        T8Product<T8EntityType<T8Unit>, T8Unit>,
        T8EntityType<T8Unit>,
        T8Unit,
    >,
>
Throws
When no version has t8cm content.

Implementation of ITwinClient.loadTwin

loadTwinWithFactories

loadTwinWithFactories<TProject, TProduct, TEntityType, TUnit>(
    twin: string | { id: string; version: number },
    projectFactory: (dto: T8ClientProjectDTO<TUnit>) => TProject,
    productFactory: (dto: T8ClientProductDTO<TUnit>) => TProduct,
    entityTypeFactory: (dto: T8ClientEntityTypeDTO<TUnit>) => TEntityType,
    unitFactory: (dto: T8ClientUnitDTO, dataModel: T8ClientModelDTO) => TUnit,
    connectProject: (
        dto: T8ClientProjectConnectionsDTO<TProduct>,
        project: TProject,
    ) => void,
    connectProduct: (
        dto: T8ClientProductConnectionsDTO<TProduct, TEntityType>,
        product: TProduct,
    ) => void,
    signal?: AbortSignal,
): Promise<Twin<TProject, TProduct, TEntityType, TUnit>>
Downloads and deserializes the T8 client model using custom factory functions for domain-specific types. When no version is specified, searches versions newest-first for one containing t8cm content.
Type Parameters
- TProject
- TProduct
- TEntityType
- TUnit
Parameters
- twin: string | { id: string; version: number }
  Twin ID string, or {id, version} to load a specific version.
- projectFactory: (dto: T8ClientProjectDTO<TUnit>) => TProject
- productFactory: (dto: T8ClientProductDTO<TUnit>) => TProduct
- entityTypeFactory: (dto: T8ClientEntityTypeDTO<TUnit>) => TEntityType
- unitFactory: (dto: T8ClientUnitDTO, dataModel: T8ClientModelDTO) => TUnit
- connectProject: (dto: T8ClientProjectConnectionsDTO<TProduct>, project: TProject) => void
- connectProduct: (
  dto: T8ClientProductConnectionsDTO<TProduct, TEntityType>,
  product: TProduct,
  ) => void
- Optionalsignal: AbortSignal
Returns Promise<Twin<TProject, TProduct, TEntityType, TUnit>>
Throws
When no version has t8cm content.

Implementation of ITwinClient.loadTwinWithFactories

loadTwinWithGeometry

loadTwinWithGeometry(
    twin: string | { id: string; version: number },
    signal?: AbortSignal,
): Promise<
    Twin<
        T8ProjectWithGeometry,
        T8ProductWithGeometry<T8EntityType<T8Unit>>,
        T8EntityType<T8Unit>,
        T8Unit,
    >,
>
Downloads and deserializes both the client model (t8cm) and geometry (t8gi/t8gd) into a combined result. When no version is specified, searches versions newest-first for one containing both t8cm and t8gi content.
Parameters
- twin: string | { id: string; version: number }
  Twin ID string, or {id, version} to load a specific version.
- Optionalsignal: AbortSignal
Returns Promise<
    Twin<
        T8ProjectWithGeometry,
        T8ProductWithGeometry<T8EntityType<T8Unit>>,
        T8EntityType<T8Unit>,
        T8Unit,
    >,
>
Throws
When no version has both t8cm and t8gi content.

Implementation of ITwinClient.loadTwinWithGeometry

putAssetAttachment

putAssetAttachment(
    twinId: string,
    assetId: string,
    attachmentId: string,
    body: AssetAttachmentPut,
    signal?: AbortSignal,
): Promise<AttachmentGet>
Updates an attachment's description / soft-delete flag. documentId is immutable — rebinding is rejected.
Parameters
- twinId: string
- assetId: string
- attachmentId: string
- body: AssetAttachmentPut
- Optionalsignal: AbortSignal
Returns Promise<AttachmentGet>
Throws
On etag mismatch (409). The error's currentAttachment carries the server's current state.

Throws
When the attachment does not exist (404).

Implementation of ITwinClient.putAssetAttachment

putAssetCategory

putAssetCategory(
    categoryId: string,
    body: AssetCategoryPut,
    signal?: AbortSignal,
): Promise<AssetCategoryGet>
Upserts an asset category. Provide an empty/missing etag for first writes and the existing etag to update.
Parameters
- categoryId: string
- body: AssetCategoryPut
- Optionalsignal: AbortSignal
Returns Promise<AssetCategoryGet>
Throws
On invalid request body (400).

Throws
On etag mismatch (409). The error's currentCategory contains the server's current state.

Implementation of ITwinClient.putAssetCategory

putAssetType

putAssetType(
    categoryId: string,
    typeId: string,
    body: AssetTypePut,
    signal?: AbortSignal,
): Promise<AssetTypeGet>
Upserts an asset type. The metadata schema is validated against the Twinfinity meta-schema at the API boundary; invalid schemas surface as a 400 with cause: MetadataSchemaInvalid.
Parameters
- categoryId: string
- typeId: string
- body: AssetTypePut
- Optionalsignal: AbortSignal
Returns Promise<AssetTypeGet>
Throws
On invalid request body (400). The error's errorBody carries the structured cause.

Throws
On etag mismatch (409). The error's currentType contains the server's current state.

Implementation of ITwinClient.putAssetType

restoreAsset

restoreAsset(twinId: string, assetId: string, etag: string): Promise<AssetGet>
Parameters
- twinId: string
- assetId: string
- etag: string
Returns Promise<AssetGet>
Throws
When the asset does not exist (404).

Throws
On etag mismatch (409). The error's currentAsset contains the server's current state.

Implementation of ITwinClient.restoreAsset

restoreAssetAttachment

restoreAssetAttachment(
    twinId: string,
    assetId: string,
    attachmentId: string,
    etag: string,
    signal?: AbortSignal,
): Promise<AttachmentGet>
Restores a soft-deleted attachment.
Parameters
- twinId: string
- assetId: string
- attachmentId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<AttachmentGet>
Throws
On etag mismatch (409).

Throws
When the attachment does not exist (404).

Implementation of ITwinClient.restoreAssetAttachment

restoreAssetCategory

restoreAssetCategory(
    categoryId: string,
    etag: string,
    signal?: AbortSignal,
): Promise<AssetCategoryGet>
Restores a soft-deleted category. Inserts a new asset_category_versions row with is_deleted=false; mirrors twin restore.
Parameters
- categoryId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<AssetCategoryGet>
Throws
When the category does not exist (404).

Throws
On etag mismatch (409).

Implementation of ITwinClient.restoreAssetCategory

restoreAssetType

restoreAssetType(
    categoryId: string,
    typeId: string,
    etag: string,
    signal?: AbortSignal,
): Promise<AssetTypeGet>
Restores a soft-deleted type. Inserts a new asset_type_versions row with is_deleted=false; mirrors twin restore.
Parameters
- categoryId: string
- typeId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<AssetTypeGet>
Throws
When the type does not exist (404).

Throws
On etag mismatch (409).

Implementation of ITwinClient.restoreAssetType

restoreTwin

restoreTwin(
    twinId: string,
    etag: string,
    signal?: AbortSignal,
): Promise<TwinGet>
Parameters
- twinId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<TwinGet>
Throws
When the twin does not exist (404).

Throws
On etag mismatch (409). The error's currentTwin contains the server's current state.

Implementation of ITwinClient.restoreTwin

restoreTwinFile

restoreTwinFile(
    twinId: string,
    fileId: string,
    etag: string,
    signal?: AbortSignal,
): Promise<TwinFileGet>
Parameters
- twinId: string
- fileId: string
- etag: string
- Optionalsignal: AbortSignal
Returns Promise<TwinFileGet>
Throws
When the file does not exist (404).

Throws
On etag mismatch (409). The error's currentTwinFile contains the server's current state.

Throws
On invalid request (400).

Implementation of ITwinClient.restoreTwinFile

updateAsset

updateAsset(
    twinId: string,
    assetId: string,
    asset: AssetPut,
    signal?: AbortSignal,
): Promise<AssetGet>
Parameters
- twinId: string
- assetId: string
- asset: AssetPut
- Optionalsignal: AbortSignal
Returns Promise<AssetGet>
Throws
On invalid request body (400). The error's errorBody has structured detail.

Throws
On etag mismatch (409). The error's currentAsset contains the server's current state.

Implementation of ITwinClient.updateAsset

updateTwin

updateTwin(
    twinId: string,
    twin: TwinPut,
    signal?: AbortSignal,
): Promise<TwinGet>
Alias for createOrUpdateTwin.
Parameters
- twinId: string
- twin: TwinPut
- Optionalsignal: AbortSignal
Returns Promise<TwinGet>
Implementation of ITwinClient.updateTwin

uploadAssetAttachmentFile

uploadAssetAttachmentFile(
    session: ApiCreateUploadSessionResponse,
    file: Blob,
    signal?: AbortSignal,
): Promise<{ token: string }>
Uploads a File / Blob to an existing upload session in one or more chunks, then resolves the upload token so the caller can poll getAssetAttachmentUploadStatus.
Parameters
- session: ApiCreateUploadSessionResponse
- file: Blob
- Optionalsignal: AbortSignal
Returns Promise<{ token: string }>
Implementation of ITwinClient.uploadAssetAttachmentFile

Class TwinClient

Implements

Index

Constructors

Accessors

Methods

Constructors

constructor

Parameters

Returns TwinClient

Accessors

baseUrl

Returns string

Methods

batchAssets

Parameters

Returns Promise<AssetBatchResponse>

Throws

Throws

Throws

batchGetAssets

Parameters

Returns Promise<AssetBatchGetResponse>

Throws

createAssetAttachmentUploadSession

Parameters

Returns Promise<ApiCreateUploadSessionResponse>

Throws

createAssets

Parameters

Returns Promise<AssetGet[]>

Throws

createOrUpdateTwin

Parameters

Returns Promise<TwinGet>

Throws

Throws

createOrUpdateTwinFile

Parameters

Returns Promise<TwinFileGet>

Throws

Throws

createOrUpdateTwinFileRaw

Parameters

Returns Promise<Response>

createOrUpdateTwinRaw

Parameters

Returns Promise<Response>

deleteAsset

Parameters

Returns Promise<AssetGet>

Throws

Throws

deleteAssetAttachment

Parameters

Returns Promise<AttachmentGet>

Throws

Throws

deleteAssetCategory

Parameters

Returns Promise<AssetCategoryGet>

Throws

Throws

deleteAssetType

Parameters

Returns Promise<AssetTypeGet>

Throws

Throws

deleteTwin

Parameters

Returns Promise<TwinGet>

Throws

Throws

deleteTwinFile

Parameters

Returns Promise<TwinFileGet>

Throws

Throws

Throws

downloadTwinContent