Skip to content

SelectAction

Selects an action for a work item and returns an array of identifiers for the next work items in the process.

Required Scope

workitem_action

Parameters

Parameter Name Description
apiKey A unique key used to authenticate and authorise the calling system.
logonId User’s logon Id.
logonProvider The authentication provider used for user login (e.g., 'Organization' for Emakin's default login system).
id The unique identifier of the work item.
action The identifier for the selected action.
data The XML data associated with the form. This can be null. (Note: There is no merge operation; the entire form data must be sent. If omitted, the form data will be replaced with the new data.

You can retrieve the current data using the GetWorkItemData method.

The final data should be enclosed within a form element, e.g. <form><Data>...</Data></form>.)
comments User comments.

Example Call

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
POST https://mydomain.emakin.com/rest/v1/selectAction

{
     "apiKey": "xxxx",
     "logonId": "[email protected]",
     "logonProvider": "Organization",
     "id": "e5134318-88bd-4a33-b561-4d78380734ce",
     "action": "c5350e5c-6e03-4b72-9522-49ab7f849b8a",
     "data": null
}

1
2
3
4
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[ "716F8FCB-98C2-4591-8C43-043D54DEAADA" ]