Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

URL

HTTP Type

Description

/entity?generatedBy={activity id}POST

Creates a new entity and creates a generatedBy connection to the provided activity.

  • Error Codes
    • 403 - Unauthorized assignment of activity. You must be the creator of the activity to connect it to an entity
    • 404 - If activityId is not found.
/entity/{id}?generatedBy={activity id}PUT

Updates the entity and creates a generatedBy connection from the current version of the entity to the provided activity.

  • Error Codes
    • 403 - Unauthorized assignment of activity. You must be the creator of the activity to connect it to an entity
    • 404 - If activityId is not found.
/entity/{id}/version?generatedBy={activityId}PUT

Creates a new version of a given version-able entity and creates a generatedBy connection to the provided activity.

  • Error Codes
    • 403 - Unauthorized assignment of activity. You must be the creator of the activity to connect it to an entity
    • 404 - If activityId is not found.
/entity/bundle?generatedBy={activityId}POST

Creates a new EntityBundle and creates a generatedBy connection to the provided activity.

  • Error Codes
    • 403 - Unauthorized assignment of activity. You must be the creator of the activity to connect it to an entity
    • 404 - If activityId is not found.
/entity/bundle?generatedBy={activityId}PUT

Updates an EntityBundle and creates a generatedBy connection to the provided activity.

  • Error Codes
    • 403 - Unauthorized assignment of activity. You must be the creator of the activity to connect it to an entity
    • 404 - If activityId is not found.

 

...

 

Provenance Additions to the API

Additions to Entity API

The following are new suffixes on the Entity services for Provenance

URL

HTTP Type

Description

/entity/{id}/generatedByGET

Returns the activity that generated the current version of the entity.

  • Error Codes
    • 404 - If the entity is not connected to an activity.
/entity/{id}/generatedBy?generatedBy={activityId}PUT

Updates the activity that generated the current version of the entity. Outside the transaction of entity CRUD.

  • Error Codes
    • 403 - Unauthorized assignment of activity. You must be the creator of the activity to connect it to an entity
    • 404 - If activityId is not found.
/entity/{id}/generatedByDELETE

Removes the generatedBy connection from the current version of the entity.

/entity/{id}/version/{versionNumber}/generatedByGET

Returns the activity that generated the specific version of the entity.

  • Error Codes
    • 404 - If that version of the entity is not connected to an activity.
/entity/{id}/version/{versionNumber}/generatedBy?generatedBy={activityId}PUTUpdates the activity that generated the specific version of the entity. Outside the transaction of entity CRUD.
/entity/{id}/version/{versionNumber}/generatedByDELETE

Removes the generatedBy connection from the specific version of the entity.

 

...

Activity API

The following table describes the new methods for manipulating the versions of a version-able entity.

...