...
The following table describes how provenance effects the current Entity CRUD API:
URL | HTTP Type | Description | |||||||
|---|---|---|---|---|---|---|---|---|---|
| /entity | POST | Creates a new entity and links it to a new UNDEFINED activity. | /entity?activityId={activity id} | POST | Create a new entity and links it to the provided activity. | /entity/{id} | PUT | Updates the entity. If the entity is version-able and the update results in a new version then a new UNDEFINED activity | is created and linked with the new version. |
| /entity/{id}?activityId={activity id} | PUT | Updates the entity and links the current version of the entity to the provided activity. | /entity/{id}/version | POST | Creates a new version of a given version-able entity and links it to a new UNDEFINED activity. | ||||
| /entity/{id}/version?activityId={activityId} | POST | Creates a new version of a given version-able entity and links it to the provided activity. | |||||||
| /entity/{id}/activity | GET | Returns the activity that generated (aka links to) the current version of the specified entity. | |||||||
| /entity/{id}/version/{versionNumber}/activity | GET | Returns the activity that generated (aka links to) the specific version of the entity. |
...