Ontologie

Queries the workspace's ontology graph. Five operations available: query (list by type), lookup (search by ID), traverse (follow relations), search (text search), aggregate (count/sum).

Common parameters

Parameter	Type	Required	Variable	Description
operation	choice (query, lookup, traverse, search, aggregate)	Yes	No	Type of operation to perform on the ontology.
limit	number	No	Yes	Maximum number of results to return. (Default: 50, min 1, max 1000)
outputFields	array	No	No	List of fields to include in the results. Empty = all fields.
outputVariable	text	No	No	Output variable name to reference results in subsequent blocks.
allSpaces	boolean	No	No	Search across all spaces in the workspace instead of the current space. (Default: false)
espaceIds	array	No	No	Specific spaces to query (when allSpaces is disabled).

Parameters marked Variable = Yes accept the {{blockName.field}} syntax.

Parameters by operation

query — Query

Search entities by type and filters.

Parameter	Type	Required	Variable	Description
entityType	text	Yes	Yes	Entity type to search for (e.g. Client, Product).
filters	array	No	No	Filter conditions (field, operator, value). Combined with AND/OR.
includeRelations	boolean	No	No	Include direct relations of found entities. (Default: false)

Parameters marked Variable = Yes accept the {{blockName.field}} syntax.

lookup — Lookup

Look up an entity by ID or unique key.

Parameter	Type	Required	Variable	Description
entityType	text	Yes	Yes	Entity type to search for.
filters	array	No	No	Filters to identify the entity (e.g. id equals "abc").

Parameters marked Variable = Yes accept the {{blockName.field}} syntax.

traverse — Traversal

Traverse graph relationships from an entity type.

Parameter	Type	Required	Variable	Description
entityType	text	Yes	Yes	Starting entity type for the traversal.
filters	array	No	No	Filters on the starting entities.
traversal.depth	number	Yes	No	Traversal depth (number of relation levels to follow). (Default: 1, min 1, max 10)
traversal.direction	choice (outgoing, incoming, both)	Yes	No	Traversal direction: outgoing, incoming, or both. (Default: "outgoing")
traversal.edgeTypes	array	No	No	Relation types to follow. Empty = all relations.
includeRelations	boolean	No	No	Include relations of found entities in results. (Default: false)

Parameters marked Variable = Yes accept the {{blockName.field}} syntax.

search — Semantic Search

Semantic similarity search on entity content.

Parameter	Type	Required	Variable	Description
searchQuery	dynamic value	Yes	Yes	Search text or dynamic variable. The engine compares against embeddings.

Parameters marked Variable = Yes accept the {{blockName.field}} syntax.

aggregate — Aggregation

Statistical calculations on entities (count, sum, average, min, max).

Parameter	Type	Required	Variable	Description
entityType	text	Yes	Yes	Entity type to aggregate on.
filters	array	No	No	Filters to restrict entities before aggregation.
aggregate.operation	choice (count, sum, avg, min, max)	Yes	No	Type of calculation to perform.
aggregate.field	text	No	Yes	Field to calculate on (required for sum, avg, min, max; optional for count).
aggregate.outputField	text	No	No	Output field name for the result. Defaults to the operation name.

Parameters marked Variable = Yes accept the {{blockName.field}} syntax.

Output

Output variable : ontologyData

{
  "success": false,
  "operation": "...",
  "entityType": "...",
  "items": [],
  "totalCount": 0,
  "returnedCount": 0
}

Example

List all entities of type Lead.

Input :

{"operation": "query", "entityType": "Lead"}

Output :

{"success": true, "operation": "query", "entityType": "Lead", "items": [{"id": "c9cb...", "name": "Lead", "type": "ObjectType", "properties": {}}], "totalCount": 15, "returnedCount": 15}

Common errors

Problem	Solution
The result is empty	Check the exact entity type name. Valid operations are: query, lookup, traverse, search, aggregate.

Tip

Use {{ontologyData.items}} for the array (not {{ontologyData.results}}). In lookup mode, the field is {{ontologyData.item}} (single object) and {{ontologyData.found}} (boolean).