Task Delegation APIs

These APIs are only required when the OneList delegation feature is enabled. Delegation is a two-way sync between OneList and the source workflow system.

Get Delegations API

This API returns all the current and future delegations of the in-scope workflows from the source workflow system.

Input parameters:

• For filtering delegation by workflow, scope/profile, optional

Return parameters:

• List of delegations with the following mandatory information

  • Delegation record id - the unique delegation record id

  • Scope - the scope of the delegation, e.g. SAP delegation profile, the workflow name

  • Delegate form user id - the source system user id

  • Delegate to user id - the source system user id

  • Start date - the delegation start date and time with time zone information

  • End date - the delegation end date and time with time zone information

• Optional attributes:

  • Workflow type - value for the delegation identification, e.g. delegation sub-system.

Save Delegations API

This API creates or updates the source workflow system delegation record.

Input parameters:

• Delegation record id - the unique delegation record id, optional for create new delegation record.

• Scope - the scope of the delegation, e.g. SAP delegation profile, the workflow name

• Delegate form user id - the source system user id

• Delegate to user id - the source system user id

• Start date - the delegation start date and time with time zone information

• End date - the delegation end date and time with time zone information

• Workflow type - Optional, value for the delegation identification, e.g. delegation sub-system.

Return parameters:

• Success or error messages

Delete Delegation API

This API deletes the delegation record.

Input parameters:

• Delegation record id - the unique delegation record id, optional for create new delegation record.

• Scope - optional, the scope of the delegation, e.g. SAP delegation profile, the workflow name

Return parameters:

• Success or error messages