APIs Required for Each Feature

Note: The mandatory APIs are required to integrate any system through SDK.

Feature
APIs to be Implemented

Basic Entity Sync

Entity APIs: * Get * Create * Update * List

Soft-Delete

Entity APIs: * Soft-Delete

Comment

Comment APIs: * Add * Get Entity Type Get API: * Provide metadata for comments

Attachment

Attachment APIs: * Get * Create * Update * Delete Entity Get and List APIs should also provide attachments Entity Type Get API: * Provide metadata for attachments

Link

Link APIs: * Create or Update * Delete Entity Get and List APIs should also provide links Entity Type Get API: * Provide metadata for links

History

History APIs: * List * Attachment * Comment * Link Entity Type Get API: * Provide metadata for history

User Mention

User APIs: * List Entity Type Get API: * Provide metadata for userMention

Inline Files / Images

Attachment APIs: * Get * Create * Update * Delete * File Name - Get Entity Type Get API: * Provide metadata for inlineFiles

Remote Entity Link

Entity Type Get API: * Provide metadata for entityWebUrl

Comment with Attachment

All the Comment and Attachment APIs

Link with Comment

All the link APIs Entity Type Get API: * Provide link comment field name in link field name info.

Criteria

Entity Type Get API: * Provide details in searchEntityInfo

Target lookup

Entity Type Get API: * Provide details in searchEntityInfo

Recovery

Entity Type Get API: * Provide metadata for Recovery

Workflow Transition

User need to configure workflow XML from mapping screen. Depending on the workflow XML, OpsHub will calculate the path from one state to another and call the update API accordingly.

Comment Author Impersonation

Comments feature should be supported. Entity Type Get API: * Provide metadata for createdUpdatedByFieldDataType

Reference Field Synchronization

Reference entity type metadata should be provided. Entity Type Get API: * In fields, provide input for referenceFieldMetadata * In fieldNameInfo, provide input for entityNameFieldName

Entity Type and Project Movement

Entity Types List API: * Provide metadata for belongsToCategories and projectMovementSupported. Entity Type Get API: * Provide the fields updateStepNumber for entityTypeFieldName and projectIdFieldName as "-3" and "-2" respectively if the end system has different API for the update of the entityType and project. Provide updateStepNumber as "-6" for both the fields if the end system has same API for update of entityType and project. By default, if no updateStepNumber for entityTypeFieldName and projectIdFieldName is given, it will be treated as having different API for entityType and project change. Entity Get API: * If entityTypeId or projectId is passed as "null", the API should return field values for the given entityId by searching it across the given scope without having the filtering on entityTypeId, projectId or both, depending on which one is "null". Entity-Update API: * Handle the update for entityType and project in case the updateSubStepNumber received is either of "-2","-3" or "-6", depending on the fields metadata given in the Entity-Get fields metadata for entityTypeIdFieldName and projectIdFieldName.

Get Entity Revisions using Utility

History – List API: * Get history filtered for a specific entity. Getting history description instead of old and new values: * If an end system returns complex history data and parsing the old and new field values is not feasible, the full history description can be returned instead. For more details, refer to the History – List API.

Last updated