Skip to main content

Types

BundleEvent

NameTypeDescription
bundleBundleThe bundle that the event is associated with.
dataBundleEventDataThe data associated with the event.
eventBundleEventTypeThe type of event that occurred.

BundleEventData

A union type that represents the different types of data that can be associated with a bundle event.

This is a representation of the following types: ConditionalGlobalPropertiesChangedEventData | WorkflowExperienceHoverEventData

BundleEventType

An enum that represents the different types of events that can be associated with a bundle.

ValueData TypeDescription
"conditional-global-properties-changed"ConditionalGlobalPropertiesChangedEventDataThe global properties have changed.
"workflow-experience-hover-enter"WorkflowExperienceHoverEventDataThe user has started hovered over a workflow experience.
"workflow-experience-hover-exit"WorkflowExperienceHoverEventDataThe user has stopped hovering over a workflow experience.

BundleStakeholderInput

NameTypeDescription
customerDetailsCustomerDetailsInputThe details of the stakeholder.
stakeholderTypeStakeholderTypeThe type of stakeholder. Controls the access level of the customer.

ConditionalGlobalPropertiesChangedEventData

NameTypeDescription
globalProperties[GlobalPropertyHandle]The new global properties.

CustomerDetailsInput

NameTypeDescription
emailAddressstringThe email address of the stakeholder.
firstNamestring?The first name of the stakeholder.
lastNamestring?The last name of the stakeholder.
phoneNumberstring?The phone number of the stakeholder.

GetWorkflowOptions

A union type that represents the different ways you can initialize a workflow experience.

This is a representation of the following types: GetWorkflowFromExternalProductOptions | GetWorkflowFromIntegrationProductOptions | GetWorkflowFromTransactionOptions

GetWorkflowFromExternalProductOptions

This will allow you to use your own system's ID's to initialize the experience.

NameTypeDescription
bulkboolean?Optional: If set to true, the experience will be initialized in bulk mode.
externalIntegrationIdstringThe ID of your external integration. This is usually the domain name of your store.
externalProductIdstringThe ID of the product on your external system.
graphqlGetWorkflowGraphqlOptions?Options related to the GraphQL request.
typestringThis must be set to "external".
workflowIdstringThe ID of the workflow to request an experience for.
workflowStatestring?Optional: Serialized JSON string of the workflow state to initialize the experience with.

GetWorkflowFromIntegrationProductOptions

This is the most common way to initialize a new workflow experience. This will initialize the experience with a product from your integration.

NameTypeDescription
bulkboolean?Optional: If set to true, the experience will be initialized in bulk mode.
graphqlGetWorkflowGraphqlOptions?Options related to the GraphQL request.
integrationProductIdstringThe product's integration ID. This can be found on the integration page, under the "Products" section.
typestringThis must be set to "integration".
workflowIdstringThe ID of the workflow to request an experience for.
workflowStatestring?Optional: Serialized JSON string of the workflow state to initialize the experience with.

GetWorkflowFromTransactionOptions

This is used to initialize the experience from a transaction. This will allow you to re-open a workflow experience for a transaction that has already been created.

NameTypeDescription
graphqlGetWorkflowGraphqlOptions?Options related to the GraphQL request.
readOnlyboolean?Optional: If set to true, the experience will be initialized in read-only mode.
transactionIdstringThe ID of the transaction to request an experience for.
typestringThis must be set to "transaction".
workflowStatestring?Optional: Serialized JSON string of the workflow state to initialize the experience with.

GetWorkflowGraphqlOptions

Options related to the getWorkflow GraphQL request.

NameTypeDescription
assetsGetWorkflowGraphqlAssetsOptions?Options related to assets in the GraphQL request.

GetWorkflowGraphqlAssetsOptions

Options related to assets in the getWorkflow GraphQL request.

NameTypeDescription
metadataboolean?Whether to include asset metadata in the GraphQL request.

StakeholderType

An enum that represents the type of stakeholder a customer is.

NameValueDescription
Owner"Owner"An owner of the entity. Has full access to the entity.
Approver"Approver"An approver of the entity. Can approve or reject the entity.
Editor"Editor"An editor of the entity. Can edit the entity.
Viewer"Viewer"A viewer of the entity. Can view the entity.

TransformCollection

NameTypeDescription
idstringThe ID of the transform collection.
namestringThe name of the transform collection.
transformsTransformCollectionTransform[]The transforms that are part of this collection.

TransformCollectionTransform

NameTypeDescription
idstringThe ID of the transform. Note that this is user-defined and not auto-generated.
namestringThe name of the transform.
positionVector3The position of the transform.
rotationVector3The rotation of the transform.
scaleVector3The scale of the transform.

Vector3

NameTypeDescription
xnumberThe X axis.
ynumberThe Y axis.
znumberThe Z axis.

WorkflowExperienceHoverEventData

NameTypeDescription
workflowExperienceWorkflowExperienceThe workflow experience that this event is associated with.