Input Types

Input types for mutations and complex queries.

Types

Type Details

EdgeAddition

Fields

EdgeFilter

GraphQL input type for filtering edges.

EdgeFilter represents a composable boolean expression evaluated against edges in a graph. Filters can target:

• edge endpoints (source / destination nodes),
• edge properties and metadata,
• temporal scope (windows, snapshots, latest),
• layer membership,
• and structural edge state (active, valid, deleted, self-loop).

Filters can be combined recursively using logical operators (And, Or, Not).

Examples (GraphQL):

Fields

The nested NodeFilter is evaluated against the source endpoint.

Example: \{ Src: \{ Name: \{ contains: "alice" \} \} \} | | dst | NodeFilter | Applies a filter to the destination node of the edge.

The nested NodeFilter is evaluated against the destination endpoint.

Example: \{ Dst: \{ Id: \{ eq: 42 \} \} \} | | property | PropertyFilterNew | Filters an edge property by name and value.

Applies to static or temporal properties depending on context.

Example: \{ Property: \{ name: "weight", gt: 0.5 \} \} | | metadata | PropertyFilterNew | Filters an edge metadata field.

Metadata is shared across all temporal versions of an edge.

Example: \{ Metadata: \{ name: "source", eq: "imported" \} \} | | temporalProperty | PropertyFilterNew | Filters a temporal edge property.

Used when the property value varies over time and must be evaluated within a temporal context.

Example: \{ TemporalProperty: \{ name: "status", eq: "active" \} \} | | and | [EdgeFilter!] | Logical AND over multiple edge filters.

All nested filters must evaluate to true.

Example: \{ And: [ \{ IsActive: true \}, \{ IsValid: true \} ] \} | | or | [EdgeFilter!] | Logical OR over multiple edge filters.

At least one nested filter must evaluate to true.

Example: \{ Or: [ \{ IsDeleted: true \}, \{ IsSelfLoop: true \} ] \} | | not | EdgeFilter | Logical NOT over a nested edge filter.

Negates the result of the wrapped filter.

Example: \{ Not: \{ IsDeleted: true \} \} | | window | EdgeWindowExpr | Restricts edge evaluation to a time window.

The window is inclusive of start and exclusive of end. | | at | EdgeTimeExpr | Restricts edge evaluation to a single point in time. | | before | EdgeTimeExpr | Restricts edge evaluation to times strictly before a given time. | | after | EdgeTimeExpr | Restricts edge evaluation to times strictly after a given time. | | latest | EdgeUnaryExpr | Evaluates edge predicates against the latest available state. | | snapshotAt | EdgeTimeExpr | Evaluates edge predicates against a snapshot of the graph at a specific time. | | snapshotLatest | EdgeUnaryExpr | Evaluates edge predicates against the most recent snapshot of the graph. | | layers | EdgeLayersExpr | Restricts evaluation to edges belonging to one or more layers.

Example: \{ Layers: \{ values: ["fire_nation", "air_nomads"] \} \} | | isActive | Boolean | Matches edges that have at least one event in the current view/window.

When true, only active edges are matched. | | isValid | Boolean | Matches edges that are structurally valid (i.e. not deleted) in the current view/window. | | isDeleted | Boolean | Matches edges that have been deleted in the current view/window. | | isSelfLoop | Boolean | Matches edges that are self-loops (source node == destination node). |

EdgeLayersExpr

Restricts edge evaluation to one or more layers and applies a nested EdgeFilter.

Used by GqlEdgeFilter::Layers.

Fields

EdgeSortBy

Fields

EdgesViewCollection

Fields

EdgeTimeExpr

Restricts edge evaluation to a single time bound and applies a nested EdgeFilter.

Used by At, Before, and After edge filters.

Fields

EdgeUnaryExpr

Applies a unary edge-view operation and then evaluates a nested EdgeFilter.

Used by Latest and SnapshotLatest edge filters.

Fields

EdgeViewCollection

Fields

EdgeWindowExpr

Restricts edge evaluation to a time window and applies a nested EdgeFilter.

Used by GqlEdgeFilter::Window.

The window is inclusive of start and exclusive of end.

Fields

EmbeddingModel

Fields

GraphFilter

GraphQL input type for restricting a graph view.

GraphFilter controls the evaluation scope for subsequent node/edge filters:

• time windows (Window)
• time points (At)
• open-ended ranges (Before, After)
• latest evaluation (Latest)
• snapshots (SnapshotAt, SnapshotLatest)
• layer membership (Layers)

These filters can be nested via the expr field on the corresponding *Expr input objects to form pipelines.

Fields

GraphLayersExpr

Graph view restriction by layer membership, optionally chaining another GraphFilter.

Used by GqlGraphFilter::Layers.

Fields

GraphTimeExpr

Graph view restriction to a single time bound, optionally chaining another GraphFilter.

Used by At, Before, and After graph filters.

Example: \{ At: \{ time: 5, expr: \{ Layers: \{ names: ["L1"] \} \} \} \}

Fields

GraphUnaryExpr

Graph view restriction that takes only a nested expression.

Used for unary view operations like Latest and SnapshotLatest.

Fields

GraphViewCollection

Fields

GraphWindowExpr

Graph view restriction to a time window, optionally chaining another GraphFilter.

Used by GqlGraphFilter::Window.

• start and end define the window (inclusive start, exclusive end).
• expr optionally nests another graph filter to apply within this window.

Example (GraphQL):

Fields

IndexSpecInput

Fields

InputEdge

Fields

NodeAddition

Fields

NodeFieldCondition

Boolean expression over a built-in node field (ID, name, or type).

This is used by NodeFieldFilterNew.where_ when filtering a specific NodeField.

Supports comparisons, string predicates, and set membership. (Presence checks and aggregations are handled via property filters instead.)

Fields

NodeFieldFilterNew

Filters a built-in node field (id, name, type) using a NodeFieldCondition.

Example (GraphQL):

Fields

Exposed as where in GraphQL. |

NodeFilter

GraphQL input type for filtering nodes.

NodeFilter represents a composable boolean expression evaluated against nodes in a graph. Filters can target:

• built-in node fields (Node / NodeFieldFilterNew),
• node properties and metadata,
• temporal properties,
• temporal scope (windows, snapshots, latest),
• and layer membership,
• plus node state predicates (e.g. IsActive).

Filters can be combined recursively using logical operators (And, Or, Not).

Fields

Metadata is shared across all temporal versions of a node. | | temporalProperty | PropertyFilterNew | Filters a temporal node property by name and condition.

Used when the property value varies over time and must be evaluated within a temporal context. | | and | [NodeFilter!] | Logical AND over multiple node filters. | | or | [NodeFilter!] | Logical OR over multiple node filters. | | not | NodeFilter | Logical NOT over a nested node filter. | | window | NodeWindowExpr | Restricts evaluation to a time window (inclusive start, exclusive end). | | at | NodeTimeExpr | Restricts evaluation to a single point in time. | | before | NodeTimeExpr | Restricts evaluation to times strictly before the given time. | | after | NodeTimeExpr | Restricts evaluation to times strictly after the given time. | | latest | NodeUnaryExpr | Evaluates predicates against the latest available node state. | | snapshotAt | NodeTimeExpr | Evaluates predicates against a snapshot of the graph at a given time. | | snapshotLatest | NodeUnaryExpr | Evaluates predicates against the most recent snapshot of the graph. | | layers | NodeLayersExpr | Restricts evaluation to nodes belonging to one or more layers. | | isActive | Boolean | Matches nodes that have at least one event in the current view/window.

When true, only active nodes are matched. |

NodeLayersExpr

Restricts node evaluation to one or more layers and applies a nested NodeFilter.

Used by GqlNodeFilter::Layers.

Fields

NodeSortBy

Fields

NodesViewCollection

Fields

NodeTimeExpr

Restricts node evaluation to a single time bound and applies a nested NodeFilter.

Used by At, Before, and After node filters.

Fields

NodeUnaryExpr

Applies a unary node-view operation and then evaluates a nested NodeFilter.

Used by Latest and SnapshotLatest node filters.

Fields

NodeViewCollection

Fields

NodeWindowExpr

Restricts node evaluation to a time window and applies a nested NodeFilter.

Used by GqlNodeFilter::Window.

The window is inclusive of start and exclusive of end.

Fields

ObjectEntry

Fields

OpenAIConfig

Fields

PathFromNodeViewCollection

Fields

PropCondition

Boolean expression over a property value.

PropCondition is used inside PropertyFilterNew.where to describe how a property’s value should be matched.

It supports:

• comparisons (Eq, Gt, Le, …),
• string predicates (Contains, StartsWith, …),
• set membership (IsIn, IsNotIn),
• presence checks (IsSome, IsNone),
• boolean composition (And, Or, Not),
• and list/aggregate qualifiers (First, Sum, Len, …).

Notes:

• Value is interpreted according to the property’s type.
• Aggregators/qualifiers like Sum and Len apply when the underlying property is list-like or aggregatable (depending on your engine rules).

Fields

When set to true, requires the property to exist. | | isNone | Boolean | Absence check: property value is missing / null.

When set to true, requires the property to be missing. | | and | [PropCondition!] | Logical AND over nested conditions. | | or | [PropCondition!] | Logical OR over nested conditions. | | not | PropCondition | Logical NOT over a nested condition. | | first | PropCondition | Applies the nested condition to the first element of a list-like property. | | last | PropCondition | Applies the nested condition to the last element of a list-like property. | | any | PropCondition | Requires that any element of a list-like property matches the nested condition. | | all | PropCondition | Requires that all elements of a list-like property match the nested condition. | | sum | PropCondition | Applies the nested condition to the sum of a numeric list-like property. | | avg | PropCondition | Applies the nested condition to the average of a numeric list-like property. | | min | PropCondition | Applies the nested condition to the minimum element of a list-like property. | | max | PropCondition | Applies the nested condition to the maximum element of a list-like property. | | len | PropCondition | Applies the nested condition to the length of a list-like property. |

PropertyFilterNew

Filters an entity property or metadata field by name and condition.

This input is used by both node and edge filters when targeting a specific property key (or metadata key) and applying a PropCondition.

Fields:

• name: The property key to query.
• where_: The condition to apply to that property’s value.

Example (GraphQL):

Fields

Exposed as where in GraphQL. |

PropertyInput

Fields

PropsInput

Fields

SomePropertySpec

SomePropertySpec object containing lists of metadata and property names.

Fields

Template

Fields

TemporalPropertyInput

Fields

Value

Fields

VectorisedGraphWindow

Fields

Window

Fields

WindowDuration

Fields

Choose from: | | epoch | Int | Time. |