Add suggestion list section to the parameters of an action in the workflow

[hadimansouri]

The response of the REST for a list of possible actions on an entity contains required and optional parameters needed by each action. Now it is a good idea to add a suggestion list section to this response to provide some hint for clients about needed resources by each parameter. For example:

{
   title: 'Set Fixer',
   id: set_fixer',
   .
   .
   .
   suggestions: [
        {
            title: 'Fixer',
            resource: '/api/v2/user/role/' + roleId + '/accounts',
        },
        {
            title: 'Zone Owner',
            resource: '/api/v2/user/role/' + zroleId + '/accounts',
        },
   ]
}

[hadimansouri]

Improvement on the suggestion section:

suggestions:[
    {
        title: 'Fixer',
        url: '/api/v2/user/role/' + roleId + '/accounts',
        filter: {
            key: value,
            key2: value2
        },
        template: 'mustache template for example {{id}}'
    },
    {
        ...
    }
]