25.9. Node properties

25.9.1. Set property on node
25.9.2. Update node properties
25.9.3. Get properties for node
25.9.4. Property values can not be null
25.9.5. Property values can not be nested
25.9.6. Delete all properties from node
25.9.7. Delete a named property from a node

25.9.1. Set property on node

Setting different properties will retain the existing ones for this node. Note that a single value are submitted not as a map but just as a value (which is valid JSON) like in the example below.

Figure 25.34. Final Graph


Example request

  • PUT http://localhost:7474/db/data/node/197/properties/foo
  • Accept: application/json
  • Content-Type: application/json
"bar"

Example response

  • 204: No Content

25.9.2. Update node properties

This will replace all existing properties on the node with the new set of attributes.

Figure 25.35. Final Graph


Example request

  • PUT http://localhost:7474/db/data/node/195/properties
  • Accept: application/json
  • Content-Type: application/json
{
  "age" : "18"
}

Example response

  • 204: No Content

25.9.3. Get properties for node

Figure 25.36. Final Graph


Example request

  • GET http://localhost:7474/db/data/node/312/properties
  • Accept: application/json

Example response

  • 200: OK
  • Content-Type: application/json
{
  "foo" : "bar"
}

25.9.4. Property values can not be null

This example shows the response you get when trying to set a property to null.

Example request

  • POST http://localhost:7474/db/data/node
  • Accept: application/json
  • Content-Type: application/json
{
  "foo" : null
}

Example response

  • 400: Bad Request
  • Content-Type: application/json
{
  "message": "Could not set property \"foo\", unsupported type: null",
  "exception": "PropertyValueException",
  "fullname": "org.neo4j.server.rest.web.PropertyValueException",
  "stacktrace": [
    "org.neo4j.server.rest.domain.PropertySettingStrategy.setProperty(PropertySettingStrategy.java:151)",
    "org.neo4j.server.rest.domain.PropertySettingStrategy.setProperties(PropertySettingStrategy.java:92)",
    "org.neo4j.server.rest.web.DatabaseActions.createNode(DatabaseActions.java:214)",
    "org.neo4j.server.rest.web.RestfulGraphDatabase.createNode(RestfulGraphDatabase.java:232)",
    "java.lang.reflect.Method.invoke(Method.java:601)",
    "org.neo4j.server.rest.security.SecurityFilter.doFilter(SecurityFilter.java:112)"
  ]
}

25.9.5. Property values can not be nested

Nesting properties is not supported. You could for example store the nested JSON as a string instead.

Example request

  • POST http://localhost:7474/db/data/node/
  • Accept: application/json
  • Content-Type: application/json
{
  "foo" : {
    "bar" : "baz"
  }
}

Example response

  • 400: Bad Request
  • Content-Type: application/json
{
  "message": "Could not set property \"foo\", unsupported type: {bar\u003dbaz}",
  "exception": "PropertyValueException",
  "fullname": "org.neo4j.server.rest.web.PropertyValueException",
  "stacktrace": [
    "org.neo4j.server.rest.domain.PropertySettingStrategy.setProperty(PropertySettingStrategy.java:151)",
    "org.neo4j.server.rest.domain.PropertySettingStrategy.setProperties(PropertySettingStrategy.java:92)",
    "org.neo4j.server.rest.web.DatabaseActions.createNode(DatabaseActions.java:214)",
    "org.neo4j.server.rest.web.RestfulGraphDatabase.createNode(RestfulGraphDatabase.java:232)",
    "java.lang.reflect.Method.invoke(Method.java:601)",
    "org.neo4j.server.rest.security.SecurityFilter.doFilter(SecurityFilter.java:112)"
  ]
}

25.9.6. Delete all properties from node

Figure 25.37. Final Graph


Example request

  • DELETE http://localhost:7474/db/data/node/349/properties
  • Accept: application/json

Example response

  • 204: No Content

25.9.7. Delete a named property from a node

To delete a single property from a node, see the example below.

Figure 25.38. Starting Graph


Figure 25.39. Final Graph


Example request

  • DELETE http://localhost:7474/db/data/node/348/properties/name
  • Accept: application/json

Example response

  • 204: No Content