Skip to content

SURF-537 Update documentation for type mismatch errors #450

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
renetapopova merged 3 commits into from
Feb 10, 2026
+47 −8
Merged

SURF-537 Update documentation for type mismatch errors #450

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
10b47ba
SURF-537 Update documentation for type mismatch errors
neo-harshg Feb 3, 2026
96ee019
editorial review of the example, add a solution
renetapopova Feb 9, 2026
8be2ba3
prepend the queries with the correct Cypher version and add labels
renetapopova Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 35 additions & 1 deletion modules/ROOT/pages/errors/gql-errors/22N27.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,41 @@
= 22N27

== Status description
error: data exception - invalid entity type. Invalid input `{ <<input>> }` for `{ <<context>> }`. Expected to be `{ <<valueTypeList>> }`.
error: data exception - invalid entity type. Invalid input `{ <<input>> }` for `{ <<context>> }`. Expected to be `{ <<valueTypeList>> }` `{ <<hint>> }`.

[NOTE]
====
The `{ <<hint>> }` segment is optional. When present, it contains additional guidance (for example: `Hint: use properties(...) on the right-hand side.`).
====

== Example scenario

For example, consider the following query, which expects a map but receives a node or relationship:

[source,cypher]
----
CYPHER 25
MATCH (a)-->(b)
SET a = b
----

You will receive an error with GQLSTATUS 22N27 and status description:

[source]
----
error: data exception - invalid entity type. Invalid input `RELATIONSHIP` for `b`. Expected to be `MAP`. Hint: use properties(...) on the right-hand side.
----

== Possible solution

To resolve this error, ensure that the input for `b` is a map. You can modify the query as follows:

[source,cypher]
----
CYPHER 25
MATCH (a)-->(b)
SET a = properties(b)
----


ifndef::backend-pdf[]
Expand Down
2 changes: 1 addition & 1 deletion modules/ROOT/pages/errors/gql-errors/index.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -266,7 +266,7 @@ Status description:: error: data exception - unsupported rounding mode. Unknown

=== xref:errors/gql-errors/22N27.adoc[22N27]

Status description:: error: data exception - invalid entity type. Invalid input `{ <<input>> }` for `{ <<context>> }`. Expected to be `{ <<valueTypeList>> }`.
Status description:: error: data exception - invalid entity type. Invalid input `{ <<input>> }` for `{ <<context>> }`. Expected to be `{ <<valueTypeList>> }` `{ <<hint>> }`.

=== xref:errors/gql-errors/22N28.adoc[22N28]

Expand Down
17 changes: 11 additions & 6 deletions modules/ROOT/pages/notifications/all-notifications.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1892,6 +1892,7 @@ MATCH (a)-[:A|B|C]-() RETURN *
======
=====

[role=label--cypher-5]
.Setting properties using a node
[.tabbed-example]
=====
Expand All @@ -1901,6 +1902,7 @@ Query::
+
[source,cypher]
----
CYPHER 5
MATCH (a)-[]-(b)
SET a = b
----
Expand All @@ -1918,6 +1920,7 @@ Use the `properties()` function to get all properties from `b`.
+
[source,cypher]
----
CYPHER 5
MATCH (a)-[]-(b)
SET a = properties(b)
----
Expand Down Expand Up @@ -1949,7 +1952,7 @@ SET a = properties(b)
======
=====


[role=label--cypher-5]
.Setting properties using a relationship
[.tabbed-example]
=====
Expand All @@ -1959,6 +1962,7 @@ Query::
+
[source,cypher]
----
CYPHER 5
MATCH (a)-[r]-(b)
SET a += r
----
Expand All @@ -1976,6 +1980,7 @@ Use the `properties()` function to get all properties from `r`.
+
[source,cypher]
----
CYPHER 5
MATCH (a)-[r]-(b)
SET a += properties(r)
----
Expand Down Expand Up @@ -2990,7 +2995,7 @@ m|Neo.ClientNotification.Request.FeatureDeprecationWarning
|Title
a|This feature is deprecated and will be removed in future versions.
|Description
a|
a|
`%s` is deprecated. It is replaced by `%s`.
|Category
m|DEPRECATION
Expand Down Expand Up @@ -4495,7 +4500,7 @@ The requested topology matched the current topology. No allocations were changed
======
=====

[role=label--new-2025.01 label--Cypher25]
[role=label--new-2025.01 label--cypher-25]
[#_neo_clientnotification_cluster_servercaughtup]
=== Server has caught up during `WAIT` command

Expand Down Expand Up @@ -4565,7 +4570,7 @@ Server `ServerId\{0e020000}` at address `localhost:20026` has caught up.
======
=====

[role=label--new-2025.01 label--Cypher25]
[role=label--new-2025.01 label--cypher-25]
[#_neo_clientnotification_cluster_serverfailed]
=== Server failed during `WAIT` command

Expand Down Expand Up @@ -4642,7 +4647,7 @@ Investigate the failing server using the provided message.
======
=====

[role=label--new-2025.01 label--Cypher25]
[role=label--new-2025.01 label--cypher-25]
[#_neo_clientnotification_cluster_servercatchingup]
=== Server is still catching up during `WAIT` command

Expand Down Expand Up @@ -4720,7 +4725,7 @@ Investigate the server and network for performance issues or increase the wait t
======
=====

[role=label--new-2025.01 label--Cypher25]
[role=label--new-2025.01 label--cypher-25]
[#_neo_clientnotification_cluster_serverunavailable]
=== Server is not available during `WAIT` command

Expand Down