APIs Required for Each Feature
Note: The mandatory APIs are required to integrate any system through SDK.
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

