- URL:
- https://<knowledgegraphserver_graph-url>/applyedits
- Methods:
POST
Description
The applyedits operation is performed on a knowledge graph service's graph resource. This operation allows you to add, delete, and update entities and relationships in the knowledge graph, and change their property values.
The user must have sufficient privileges to edit content and editing must be enabled for the knowledge graph service for this operation to be successful. Editing can be enabled for a knowledge graph service in the same manner that you enable it for a hosted feature layer.
GraphDefaultRollbackOnFailure
The service definition setting graph determines the behavior when errors occur during the applyedits operation.
Graph behavior is described below:
-
true—If an error occurs while importing edits on the server, all edits are rolled back (not applied), and the operation returns an error in the response. -
false—If an error occurs while importing an edit on the server, the import process skips the edit and continues. TheApplywill provide all edits that succeeded and which edits failed.Edits Response
The default setting for graph is specific to the database used in the knowledge graph service. The default setting can not be updated in the service definition. The table below provides the default setting based on the database:
| Database | graphDefaultRollbackOnFailure |
|---|---|
ArangoDB database | False |
Neo4j databse | true |
Requests and responses
This operation can only be performed by sending a PBF-formatted request and receiving a PBF-formatted response. Details of the request and response parameters are provided in the appropriate .proto files. The knowledge-pbf ReadMe file contains more information on how to execute a PBF-formatted apply edits request and how to read a PBF-formatted apply edits response.
PBF Request
Create a PBF-formatted request to perform this operation based on the Apply file.
PBF Response
Create a PBF-formatted response to get feedback from the operation based on the Apply file.