22.5. Nodes

Prev		Next

22.5.1. Create node
22.5.2. Create node with properties
22.5.3. Get node
22.5.4. Get non-existent node
22.5.5. Delete node
22.5.6. Nodes with relationships can not be deleted

22.5.1. Create node

Figure 22.8. Final Graph

Example request

POST http://localhost:7474/db/data/node
Accept: application/json; charset=UTF-8

Example response

201: Created
Content-Type: application/json; charset=UTF-8
Location: http://localhost:7474/db/data/node/215

{
  "extensions" : {
  },
  "paged_traverse" : "http://localhost:7474/db/data/node/215/paged/traverse/{returnType}{?pageSize,leaseTime}",
  "outgoing_relationships" : "http://localhost:7474/db/data/node/215/relationships/out",
  "traverse" : "http://localhost:7474/db/data/node/215/traverse/{returnType}",
  "all_typed_relationships" : "http://localhost:7474/db/data/node/215/relationships/all/{-list|&|types}",
  "property" : "http://localhost:7474/db/data/node/215/properties/{key}",
  "all_relationships" : "http://localhost:7474/db/data/node/215/relationships/all",
  "self" : "http://localhost:7474/db/data/node/215",
  "outgoing_typed_relationships" : "http://localhost:7474/db/data/node/215/relationships/out/{-list|&|types}",
  "properties" : "http://localhost:7474/db/data/node/215/properties",
  "incoming_relationships" : "http://localhost:7474/db/data/node/215/relationships/in",
  "incoming_typed_relationships" : "http://localhost:7474/db/data/node/215/relationships/in/{-list|&|types}",
  "create_relationship" : "http://localhost:7474/db/data/node/215/relationships",
  "data" : {
  }
}

22.5.2. Create node with properties

Figure 22.9. Final Graph

Example request

POST http://localhost:7474/db/data/node
Accept: application/json; charset=UTF-8
Content-Type: application/json

{
  "foo" : "bar"
}

Example response

201: Created
Content-Length: 1120
Content-Type: application/json; charset=UTF-8
Location: http://localhost:7474/db/data/node/211

{
  "extensions" : {
  },
  "paged_traverse" : "http://localhost:7474/db/data/node/211/paged/traverse/{returnType}{?pageSize,leaseTime}",
  "outgoing_relationships" : "http://localhost:7474/db/data/node/211/relationships/out",
  "traverse" : "http://localhost:7474/db/data/node/211/traverse/{returnType}",
  "all_typed_relationships" : "http://localhost:7474/db/data/node/211/relationships/all/{-list|&|types}",
  "property" : "http://localhost:7474/db/data/node/211/properties/{key}",
  "all_relationships" : "http://localhost:7474/db/data/node/211/relationships/all",
  "self" : "http://localhost:7474/db/data/node/211",
  "outgoing_typed_relationships" : "http://localhost:7474/db/data/node/211/relationships/out/{-list|&|types}",
  "properties" : "http://localhost:7474/db/data/node/211/properties",
  "incoming_relationships" : "http://localhost:7474/db/data/node/211/relationships/in",
  "incoming_typed_relationships" : "http://localhost:7474/db/data/node/211/relationships/in/{-list|&|types}",
  "create_relationship" : "http://localhost:7474/db/data/node/211/relationships",
  "data" : {
    "foo" : "bar"
  }
}

22.5.3. Get node

Note that the response contains URI/templates for the available operations for getting properties and relationships.

Figure 22.10. Final Graph

Example request

GET http://localhost:7474/db/data/node/85
Accept: application/json; charset=UTF-8

Example response

200: OK
Content-Type: application/json; charset=UTF-8

{
  "extensions" : {
  },
  "paged_traverse" : "http://localhost:7474/db/data/node/85/paged/traverse/{returnType}{?pageSize,leaseTime}",
  "outgoing_relationships" : "http://localhost:7474/db/data/node/85/relationships/out",
  "traverse" : "http://localhost:7474/db/data/node/85/traverse/{returnType}",
  "all_typed_relationships" : "http://localhost:7474/db/data/node/85/relationships/all/{-list|&|types}",
  "property" : "http://localhost:7474/db/data/node/85/properties/{key}",
  "all_relationships" : "http://localhost:7474/db/data/node/85/relationships/all",
  "self" : "http://localhost:7474/db/data/node/85",
  "outgoing_typed_relationships" : "http://localhost:7474/db/data/node/85/relationships/out/{-list|&|types}",
  "properties" : "http://localhost:7474/db/data/node/85/properties",
  "incoming_relationships" : "http://localhost:7474/db/data/node/85/relationships/in",
  "incoming_typed_relationships" : "http://localhost:7474/db/data/node/85/relationships/in/{-list|&|types}",
  "create_relationship" : "http://localhost:7474/db/data/node/85/relationships",
  "data" : {
  }
}

22.5.4. Get non-existent node

Figure 22.11. Final Graph

Example request

GET http://localhost:7474/db/data/node/8900000
Accept: application/json; charset=UTF-8

Example response

404: Not Found
Content-Type: application/json; charset=UTF-8

{
  "message": "Cannot find node with id [8900000] in database.",
  "exception": "NodeNotFoundException",
  "fullname": "org.neo4j.server.rest.web.NodeNotFoundException",
  "stacktrace": [
    "org.neo4j.server.rest.web.DatabaseActions.node(DatabaseActions.java:156)",
    "org.neo4j.server.rest.web.DatabaseActions.getNode(DatabaseActions.java:212)",
    "org.neo4j.server.rest.web.RestfulGraphDatabase.getNode(RestfulGraphDatabase.java:237)",
    "java.lang.reflect.Method.invoke(Method.java:597)"
  ]
}

22.5.5. Delete node

Figure 22.12. Final Graph

Example request

DELETE http://localhost:7474/db/data/node/212
Accept: application/json; charset=UTF-8

Example response

204: No Content

22.5.6. Nodes with relationships can not be deleted

The relationships on a node has to be deleted before the node can be deleted.

Figure 22.13. Final Graph

Final-Graph-Nodes-with-relationships-can-not-be-deleted.svg

Example request

DELETE http://localhost:7474/db/data/node/219
Accept: application/json; charset=UTF-8

Example response

409: Conflict
Content-Type: application/json; charset=UTF-8

{
  "message": "The node with id 219 cannot be deleted. Check that the node is orphaned before deletion.",
  "exception": "OperationFailureException",
  "fullname": "org.neo4j.server.rest.web.OperationFailureException",
  "stacktrace": [
    "org.neo4j.server.rest.web.DatabaseActions.deleteNode(DatabaseActions.java:233)",
    "org.neo4j.server.rest.web.RestfulGraphDatabase.deleteNode(RestfulGraphDatabase.java:251)",
    "java.lang.reflect.Method.invoke(Method.java:597)"
  ]
}