From d998ce391f6a51a8940ea08351cf467f5e9b2e12 Mon Sep 17 00:00:00 2001
From: Roly Rudy Gutierrez Pinto <gproly@gmail.com>
Date: Wed, 18 Oct 2017 10:47:40 -0400
Subject: [PATCH] HOR-3968

---
 .../src/ProcessMaker/Services/Api/Cases.php   |  38 +++--
 .../Services/Api/Cases/InputDocument.php      |  13 +-
 .../Services/Api/Cases/OutputDocument.php     |  15 +-
 .../Services/Api/Cases/Variable.php           |  10 +-
 .../src/ProcessMaker/Services/Api/Catalog.php |   9 +-
 .../Services/Api/Consolidated.php             |   6 +-
 .../ProcessMaker/Services/Api/Dashboard.php   |  28 +++-
 .../ProcessMaker/Services/Api/Department.php  |  22 ++-
 .../ProcessMaker/Services/Api/EmailServer.php |  14 +-
 .../src/ProcessMaker/Services/Api/File.php    |   6 +-
 .../src/ProcessMaker/Services/Api/Group.php   |   8 +-
 .../ProcessMaker/Services/Api/Group/User.php  |  18 ++-
 .../src/ProcessMaker/Services/Api/Light.php   | 132 ++++++++++++++----
 .../src/ProcessMaker/Services/Api/Process.php |   7 +-
 .../Api/Project/Activity/Assignee.php         |  20 ++-
 .../Services/Api/Project/Activity/Step.php    |  20 ++-
 .../Api/Project/Activity/Step/Trigger.php     |  20 ++-
 .../Services/Api/Project/CaseScheduler.php    |  10 +-
 .../Api/Project/CaseTrackerObject.php         |  10 +-
 .../Api/Project/DataBaseConnection.php        |  18 ++-
 .../Services/Api/Project/DynaForm.php         |  34 +++--
 .../Services/Api/Project/EmailEvent.php       |   4 +-
 .../Services/Api/Project/FilesManager.php     |  16 ++-
 .../Services/Api/Project/InputDocument.php    |  10 +-
 .../Api/Project/MessageEventDefinition.php    |  10 +-
 .../Services/Api/Project/MessageType.php      |  10 +-
 .../Api/Project/MessageType/Variable.php      |   8 +-
 .../Services/Api/Project/OutputDocuments.php  |  10 +-
 .../Api/Project/ProcessPermissions.php        |  10 +-
 .../Api/Project/ProcessSupervisors.php        |  30 ++--
 .../Services/Api/Project/ProjectUsers.php     |   8 +-
 .../Services/Api/Project/ReportTable.php      |  10 +-
 .../Services/Api/Project/ScriptTask.php       |  10 +-
 .../Services/Api/Project/TimerEvent.php       |  10 +-
 .../Services/Api/Project/Trigger.php          |  10 +-
 .../Services/Api/Project/TriggerWizard.php    |  10 +-
 .../Services/Api/Project/Variable.php         |  30 +++-
 .../Services/Api/Project/WebEntry.php         |  10 +-
 .../Services/Api/Project/WebEntryEvent.php    |  10 +-
 39 files changed, 498 insertions(+), 176 deletions(-)

diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Cases.php b/workflow/engine/src/ProcessMaker/Services/Api/Cases.php
index 9166322e7..b6e1e1a1e 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Cases.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Cases.php
@@ -756,12 +756,18 @@ class Cases extends Api
     }
 
     /**
+     * Start a new case and assign the logged-in user to work on the initial task 
+     * in the case. Note that the logged-in user must be in the pool of assigned 
+     * users for the initial task.
+     * 
      * @url POST
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $pro_uid {@from body} {@min 32}{@max 32}
      * @param string $tas_uid {@from body} {@min 32}{@max 32}
      * @param array $variables {@from body}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doPostCase($pro_uid, $tas_uid, $variables = null)
     {
@@ -776,13 +782,23 @@ class Cases extends Api
     }
 
     /**
+     * Creates a new case. It is similar to POST /cases, but it impersonates the 
+     * session variables, so it is more robust than POST /cases. Note that the 
+     * specified user to work on the case must be assigned to the pool of users 
+     * for the initial task. Also note that the new case's status will be set to 
+     * "DRAFT", not "TO_DO". If wishing to change the new case's status to "TO_DO", 
+     * then create the following trigger in the process and use 
+     * PUT /cases/{app_uid}/execute-trigger/{tri_uid} to execute it.
+     * 
      * @url POST /impersonate
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $pro_uid {@from body} {@min 32}{@max 32}
      * @param string $usr_uid {@from body} {@min 32}{@max 32}
      * @param string $tas_uid {@from body} {@min 32}{@max 32}
      * @param array $variables {@from body}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doPostCaseImpersonate($pro_uid, $usr_uid, $tas_uid, $variables = null)
     {
@@ -1095,14 +1111,18 @@ class Cases extends Api
     }
 
     /**
-     * Put Case Variables
+     * Create a new case note for a given case. Note that only users who are 
+     * currently assigned to work on the case or have Process Permissions to 
+     * access case notes may create a case note.
      *
      * @url POST /:app_uid/note
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $app_uid {@min 1}{@max 32}
      * @param string $note_content {@min 1}{@max 500}
      * @param int $send_mail {@choice 1,0}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doPostCaseNote($app_uid, $note_content, $send_mail = 0)
     {
@@ -1231,9 +1251,11 @@ class Cases extends Api
      * Mark a task process as a bookmark
      * 
      * @url POST /bookmark/:tas_uid
+     * 
+     * @param string $tas_uid {@min 32}{@max 32}
+     * 
      * @access protected
      * @class AccessControl {@permission PM_CASES}
-     * @param string $tas_uid {@min 32}{@max 32}
      */
     public function doPostBookmarkStartCase($tas_uid)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Cases/InputDocument.php b/workflow/engine/src/ProcessMaker/Services/Api/Cases/InputDocument.php
index e413e2896..03da8e24b 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Cases/InputDocument.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Cases/InputDocument.php
@@ -56,8 +56,6 @@ class InputDocument extends Api
     }
 
     /**
-     * @access protected
-     * @class AccessControl {@className \ProcessMaker\Services\Api\Cases}
      * @url GET /:app_uid/input-document/:app_doc_uid/file
      *
      * @param string $app_uid {@min 32}{@max 32}
@@ -96,13 +94,20 @@ class InputDocument extends Api
     }
 
     /**
+     * Uploads a new Input Document file to a specified case. Note that the 
+     * logged-in user must either be currently assigned to work on the case or a 
+     * Process Supervisor with permissions to access the Input Document; otherwise, 
+     * this endpoint returns an HTTP status code of 302.
+     * 
      * @url POST /:app_uid/input-document
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $app_uid         { @min 32}{@max 32}
      * @param string $tas_uid         {@min 32}{@max 32}
      * @param string $app_doc_comment
      * @param string $inp_doc_uid     {@min 32}{@max 32}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doPostInputDocument($app_uid, $tas_uid, $app_doc_comment, $inp_doc_uid)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Cases/OutputDocument.php b/workflow/engine/src/ProcessMaker/Services/Api/Cases/OutputDocument.php
index 65bc75ff8..04dfe4296 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Cases/OutputDocument.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Cases/OutputDocument.php
@@ -133,12 +133,23 @@ class OutputDocument extends Api
     }
 
     /**
+     * Generate a specified Output Document for a given case, meaning that a PDF, 
+     * a DOC or both files (depending on options selected in the definition of the 
+     * Output Document) will be created, inserting any variables in the template. 
+     * If the Output Document already exists, then it will be regenerated. 
+     * If versioning is enabled, then the regenerated files will be given a new 
+     * version number and document index number, but if versioning is NOT enabled, 
+     * then the existing files will be overwritten with the same version number 
+     * and document index number.
+     * 
      * @url POST /:app_uid/:del_index/output-document/:out_doc_uid
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $app_uid     {@min 32}{@max 32}
      * @param int    $del_index   {@min 1}
      * @param string $out_doc_uid {@min 32}{@max 32}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doPostOutputDocument($app_uid, $del_index, $out_doc_uid)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Cases/Variable.php b/workflow/engine/src/ProcessMaker/Services/Api/Cases/Variable.php
index 4884aa284..befc33e80 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Cases/Variable.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Cases/Variable.php
@@ -78,14 +78,18 @@ class Variable extends Api
     }
 
     /**
+     * Create a variable in a case, meaning the variable is instantiated in the case.
+     * 
      * @url POST /:app_uid/:del_index/variable/:var_name
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * @status 201
+     * 
      * @param string $app_uid      {@min 32}{@max 32}
      * @param int    $del_index    {@min 1}
      * @param string $var_name
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doPostVariable($app_uid, $del_index, $var_name, array $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Catalog.php b/workflow/engine/src/ProcessMaker/Services/Api/Catalog.php
index d445c1a8c..d8776f2fd 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Catalog.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Catalog.php
@@ -38,11 +38,16 @@ class Catalog extends Api
     }
 
     /**
+     * Deprecated.
+     * 
      * @url POST
+     * @status 201
+     * 
+     * @param array $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_DASHBOARD}
-     * @param array $request_data
-     * @status 201
+     * @deprecated The method has been deprecated.
      */
     public function doPost($request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Consolidated.php b/workflow/engine/src/ProcessMaker/Services/Api/Consolidated.php
index bc90f1342..8874eb82e 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Consolidated.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Consolidated.php
@@ -135,14 +135,16 @@ class Consolidated extends Api
      *
      * @url POST /derivate/:app_uid/:app_number/:del_index/:field_grid/:field_grid_val
      * @url POST /derivate/:app_uid/:app_number/:del_index/:field_grid/
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $app_uid {@min 1} {@max 32}
      * @param string $app_number
      * @param int $del_index
      * @param string $field_grid
      * @param string $field_grid_val
      * @return array
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doPostDerivate($app_uid, $app_number, $del_index, $field_grid, $field_grid_val = '')
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Dashboard.php b/workflow/engine/src/ProcessMaker/Services/Api/Dashboard.php
index 29e65aeb0..45a8a254d 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Dashboard.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Dashboard.php
@@ -220,11 +220,15 @@ class Dashboard extends Api
     }
 
     /**
+     * Create dashboard.
+     * 
      * @url POST
+     * @status 201
+     * 
+     * @param array $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_DASHBOARD}
-     * @param array $request_data
-     * @status 201
      */
     public function doPostDashboard($request_data)
     {
@@ -278,11 +282,15 @@ class Dashboard extends Api
     }
 
     /**
+     * Create owner
+     * 
      * @url POST /owner
+     * @status 201
+     * 
+     * @param array $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_DASHBOARD}
-     * @param array $request_data
-     * @status 201
      */
     public function doPostOwner($request_data)
     {
@@ -315,11 +323,15 @@ class Dashboard extends Api
     }
 
     /**
+     * Create indicator.
+     * 
      * @url POST /indicator
+     * @status 201
+     * 
+     * @param array $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_DASHBOARD}
-     * @param array $request_data
-     * @status 201
      */
     public function doPostIndicator($request_data)
     {
@@ -374,9 +386,11 @@ class Dashboard extends Api
      * Post dashboards configuration by userUid
      *
      * @url POST /config/
+     * 
+     * @param array $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_DASHBOARD}
-     * @param array $request_data
      */
     public function doPostDashboardConfigByUsrUid($request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Department.php b/workflow/engine/src/ProcessMaker/Services/Api/Department.php
index 697130f86..8403388a7 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Department.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Department.php
@@ -102,12 +102,18 @@ class Department extends Api
     }
 
     /**
+     * Assign a user to a specified department in version 3.0 and later. If the 
+     * user is already a member of another department, the user will be transfered 
+     * to the specified department.
+     * 
      * @url POST /:dep_uid/assign-user
-     * @access protected
-     * @class AccessControl {@permission PM_USERS}
+     * @status 201
+     * 
      * @param string $dep_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_USERS}
      */
     public function doPostAssignUser($dep_uid, array $request_data)
     {
@@ -179,13 +185,17 @@ class Department extends Api
     }
 
     /**
+     * Create a new department.
+     * 
      * @url POST
-     * @access protected
-     * @class AccessControl {@permission PM_USERS}
+     * @status 201
+     * 
      * @param array $request_data
      * @param string $dep_title {@from body} {@min 1}
      * @return array
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_USERS}
      */
     public function doPost($request_data, $dep_title)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/EmailServer.php b/workflow/engine/src/ProcessMaker/Services/Api/EmailServer.php
index e524bf878..573e97a4e 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/EmailServer.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/EmailServer.php
@@ -85,10 +85,14 @@ class EmailServer extends Api
     }
 
     /**
+     * Test connection.
+     * 
      * @url POST /test-connection
+     * 
+     * @param array $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_SETUP_EMAIL}
-     * @param array $request_data
      */
     public function doPostTestConnection(array $request_data)
     {
@@ -104,11 +108,15 @@ class EmailServer extends Api
     }
 
     /**
+     * Create email server.
+     * 
      * @url POST
+     * @status 201
+     * 
+     * @param array $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_SETUP_EMAIL}
-     * @param array $request_data
-     * @status 201
      */
     public function doPost(array $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/File.php b/workflow/engine/src/ProcessMaker/Services/Api/File.php
index 574f836ff..ca1d1593a 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/File.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/File.php
@@ -12,10 +12,14 @@ use \Luracast\Restler\RestException;
 class File extends Api
 {
     /**
+     * Upload file.
+     * 
      * @url POST /upload
+     * 
+     * @param array  $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_FACTORY}
-     * @param array  $request_data
      */
     public function doPostFilesUpload($request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Group.php b/workflow/engine/src/ProcessMaker/Services/Api/Group.php
index e06c8f7cd..3e7b3bf3a 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Group.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Group.php
@@ -73,11 +73,15 @@ class Group extends Api
     }
 
     /**
+     * Create a new group.
+     * 
      * @url POST
+     * @status 201
+     * 
+     * @param array $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_USERS}
-     * @param array $request_data
-     * @status 201
      */
     public function doPost($request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Group/User.php b/workflow/engine/src/ProcessMaker/Services/Api/Group/User.php
index 837c74dce..a25d45cbf 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Group/User.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Group/User.php
@@ -12,12 +12,16 @@ use \Luracast\Restler\RestException;
 class User extends Api
 {
     /**
+     * Assign a user to a specified group.
+     * 
      * @url POST /:grp_uid/user
-     * @access protected
-     * @class AccessControl {@permission PM_USERS}
+     * @status 201
+     * 
      * @param string $grp_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_USERS}
      */
     public function doPostUser($grp_uid, $request_data)
     {
@@ -32,11 +36,15 @@ class User extends Api
     }
 
     /**
+     * Assign a group of users to a specified group or groups.
+     * 
      * @url POST /batch-users
+     * @status 201
+     * 
+     * @param array $request_data
+     * 
      * @access protected
      * @class AccessControl {@permission PM_USERS}
-     * @param array $request_data
-     * @status 201
      */
     public function doPostBatchUsers($request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Light.php b/workflow/engine/src/ProcessMaker/Services/Api/Light.php
index c6c96b734..f3eb5bf2f 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Light.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Light.php
@@ -968,13 +968,15 @@ class Light extends Api
      * Execute Trigger case
      *
      * @url POST /process/:prj_uid/task/:act_uid/case/:cas_uid/step/:step_uid/execute-trigger/:type
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $prj_uid {@min 1}{@max 32}
      * @param string $act_uid {@min 1}{@max 32}
      * @param string $cas_uid {@min 1}{@max 32}
      * @param string $step_uid {@min 32}{@max 32}
      * @param string $type {@choice before,after}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doPutExecuteTriggerCase($prj_uid, $act_uid, $cas_uid, $step_uid, $type)
     {
@@ -1132,11 +1134,18 @@ class Light extends Api
     }
 
     /**
+     * Starts a new case and assigns the logged-in user to work on the initial task 
+     * in the case. Note that the logged-in user must be in the pool of assigned 
+     * users of the initial task. Also note that the new case's status will be 
+     * set to "DRAFT", not "TO_DO".
+     * 
      * @url POST /process/:pro_uid/task/:task_uid/start-case
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $pro_uid {@min 32}{@max 32}
      * @param string $task_uid {@min 32}{@max 32}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function postStartCase($pro_uid, $task_uid)
     {
@@ -1228,12 +1237,17 @@ class Light extends Api
     }
 
     /**
+     * Generates a Google Maps .jpg image file for a case. This image can be found 
+     * in the Documents section under the Home tab.
+     * 
      * @url POST /case/:app_uid/upload/location
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $app_uid { @min 32}{@max 32}
      * @param float $latitude {@min -90}{@max 90}
      * @param float $longitude {@min -180}{@max 180}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function postInputDocumentLocation($app_uid, $latitude, $longitude)
     {
@@ -1271,10 +1285,14 @@ class Light extends Api
     }
 
     /**
+     * Generates a base64 string of a file.
+     * 
      * @url POST /case/:app_uid/download64
+     * 
+     * @param string $app_uid {@min 32}{@max 32}
+     * 
      * @access protected
      * @class AccessControl {@permission PM_CASES}
-     * @param string $app_uid {@min 32}{@max 32}
      */
     public function postDownloadFile($app_uid, $request_data)
     {
@@ -1370,12 +1388,24 @@ class Light extends Api
     }
 
     /**
+     * Creates new case file record(s) in a specified case. These case files can 
+     * be attached files (used by File controls), Input Document files, or Output Document 
+     * files in version 1.0.1.8 and later. In version 1.0.1.7 and earlier, the case 
+     * files can only be attached files. (Note that case files are known as AppDocuments 
+     * in ProcessMaker). This endpoint adds new record(s) to the APP_DOCUMENT table 
+     * and stores their file name(s) in the CONTENT table in the database. It returns 
+     * the generated case file ID and version number for each file. This information 
+     * can then be used to call the POST /light/case/{app_uid}/upload/{app_doc_uid} 
+     * endpoint to upload each file.
+     * 
      * @url POST /case/:app_uid/upload
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param $access
      * @param $refresh
      * @return mixed
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function uidUploadFiles($app_uid, $request_data)
     {
@@ -1391,12 +1421,24 @@ class Light extends Api
     }
 
     /**
+     * Creates new case file record(s) in a specified case. These case files can 
+     * be attached files (used by File controls), Input Document files, or Output Document 
+     * files in version 1.0.1.8 and later. In version 1.0.1.7 and earlier, the case 
+     * files can only be attached files. (Note that case files are known as AppDocuments 
+     * in ProcessMaker). This endpoint adds new record(s) to the APP_DOCUMENT table 
+     * and stores their file name(s) in the CONTENT table in the database. It returns 
+     * the generated case file ID and version number for each file. This information 
+     * can then be used to call the POST /light/case/{app_uid}/upload/{app_doc_uid} 
+     * endpoint to upload each file.
+     * 
      * @url POST /case/:app_uid/upload/:app_doc_uid
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param $access
      * @param $refresh
      * @return mixed
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function documentUploadFiles($app_uid, $app_doc_uid, $request_data)
     {
@@ -1412,11 +1454,15 @@ class Light extends Api
     }
 
     /**
+     * Assigns the user logged-in to an unassigned case.
+     * 
      * @url POST /case/:app_uid/claim
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param $app_uid {@min 1}{@max 32}
      * @return mixed
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function claimCaseUser($app_uid)
     {
@@ -1503,15 +1549,18 @@ class Light extends Api
     }
 
     /**
-     * Post Case Notes
+     * Creates a new case note for a given case. Note that only users who are 
+     * currently assigned to work on the case or have Process Permissions to access 
+     * case notes may create a case note.
      *
      * @url POST /case/:app_uid/note
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $app_uid {@min 1}{@max 32}
      * @param string $noteContent {@min 1}{@max 500}
      * @param int $sendMail {@choice 1,0}
-     * @copyright Colosa - Bolivia
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doPostCaseNote($app_uid, $noteContent, $sendMail = 0)
     {
@@ -1596,13 +1645,18 @@ class Light extends Api
     }
 
     /**
+     * Reassign a case.
+     * 
      * @url POST /reassign/:app_uid/user/:to_usr_uid
-     * @access protected
-     * @class AccessControl {@permission PM_REASSIGNCASE, PM_REASSIGNCASE_SUPERVISOR}
+     * 
      * @param string $app_uid {@min 1}{@max 32}
      * @param string $to_usr_uid {@min 1}{@max 32}
+     * 
      * @return stdclass
      * @throws RestException
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_REASSIGNCASE, PM_REASSIGNCASE_SUPERVISOR}
      */
     public function reassignCase($app_uid, $to_usr_uid)
     {
@@ -1621,11 +1675,14 @@ class Light extends Api
      * Paused Case
      *
      * @url POST /cases/:app_uid/pause
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $app_uid {@min 1}{@max 32}
+     * 
      * @return stdclass
      * @throws RestException
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function pauseCase($app_uid, $request_data)
     {
@@ -1645,11 +1702,14 @@ class Light extends Api
      * Unpaused Case
      *
      * @url POST /cases/:app_uid/unpause
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param string $app_uid {@min 1}{@max 32}
+     * 
      * @return stdclass
      * @throws RestException
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function unpauseCase($app_uid)
     {
@@ -1667,12 +1727,16 @@ class Light extends Api
     }
 
     /**
-     * Cancel Case
+     * Cancels a case assigned to the user logged-in. The case's status is changed 
+     * to "CANCELLED" and it is no longer possible to open or change the case, 
+     * but all the case data will remain in the database.
      *
      * @url POST /cases/:app_uid/cancel
+     * 
+     * @param string $cas_uid {@min 1}{@max 32}
+     * 
      * @access protected
      * @class AccessControl {@permission PM_CASES}
-     * @param string $cas_uid {@min 1}{@max 32}
      */
     public function doPutCancelCase($app_uid)
     {
@@ -1838,12 +1902,19 @@ class Light extends Api
     }
 
     /**
-     * Get next step
+     * This endpoint executes the following three actions:
+     * 1. Executes a trigger before a step: First, it executes any trigger assigned 
+     * before the indicated step.
+     * 2. Get the Next Step: It obtains the details about the next step of the case.
+     * 3. Get Variables: Finally, it returns any variable stored or changed by 
+     * actions 1 and 2.
      *
      * @url POST /get-next-step/:app_uid
+     * 
+     * @return array
+     * 
      * @access protected
      * @class AccessControl {@permission PM_CASES}
-     * @return array
      */
     public function doGetStep($app_uid, $request_data)
     {
@@ -1941,11 +2012,14 @@ class Light extends Api
      * the specified user.
      * 
      * @url POST /draft/check
-     * @access protected
-     * @class AccessControl {@permission PM_CASES}
+     * 
      * @param array $requestData
+     * 
      * @return array $response
      * @throws Exception
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_CASES}
      */
     public function doGetDraftCheck($requestData)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Process.php b/workflow/engine/src/ProcessMaker/Services/Api/Process.php
index 29481f6ff..0d912cf66 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Process.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Process.php
@@ -64,10 +64,13 @@ class Process extends Api
     }
 
     /**
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * Create process
+     * 
      * @param array $request_data
      * @return array
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function post($request_data = null)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Assignee.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Assignee.php
index f2dcb1403..cce8b1699 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Assignee.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Assignee.php
@@ -92,14 +92,18 @@ class Assignee extends Api
     }
 
     /**
+     * Assigns a user or group to a task.
+     * 
      * @url POST /:prjUid/activity/:actUid/assignee
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prjUid {@min 32} {@max 32}
      * @param string $actUid {@min 32} {@max 32}
      * @param string $aas_uid {@min 32} {@max 32}
      * @param string $aas_type {@choice user,group}
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostActivityAssignee($prjUid, $actUid, $aas_uid, $aas_type)
     {
@@ -191,14 +195,18 @@ class Assignee extends Api
     }
 
     /**
+     * Assigns a user or group to a task on an ad hoc basis.
+     * 
      * @url POST /:prjUid/activity/:actUid/adhoc-assignee
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prjUid {@min 32} {@max 32}
      * @param string $actUid {@min 32} {@max 32}
      * @param string $ada_uid {@min 32} {@max 32}
      * @param string $ada_type {@choice user,group}
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostActivityAdhocAssignee($prjUid, $actUid, $ada_uid, $ada_type)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Step.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Step.php
index ed7252d1f..143d38a1e 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Step.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Step.php
@@ -34,9 +34,11 @@ class Step extends Api
     }
 
     /**
+     * Assigns a step to a task.
+     * 
      * @url POST /:prj_uid/activity/:act_uid/step
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $act_uid        {@min 32}{@max 32}
      * @param string $prj_uid        {@min 32}{@max 32}
      * @param array  $request_data
@@ -45,7 +47,9 @@ class Step extends Api
      * @param string $step_condition {@from body}
      * @param int    $step_position  {@from body}{@min 1}
      * @param string $step_mode      {@from body}{@choice EDIT,VIEW}{@required true}
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostActivityStep(
         $act_uid,
@@ -218,9 +222,11 @@ class Step extends Api
     }
 
     /**
+     * Create Steps for a Task.
+     * 
      * @url POST /:prj_uid/activity/:act_uid/step/all
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $act_uid        {@min 32}{@max 32}
      * @param string $prj_uid        {@min 32}{@max 32}
      * @param array  $request_data
@@ -229,7 +235,9 @@ class Step extends Api
      * @param string $step_condition {@from body}
      * @param int    $step_position  {@from body}{@min 1}
      * @param string $step_mode      {@from body}{@choice EDIT,VIEW}{@required true}
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostActivityStepAll(
         $act_uid,
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Step/Trigger.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Step/Trigger.php
index 81af8c9ef..038e0b3b6 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Step/Trigger.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/Activity/Step/Trigger.php
@@ -34,14 +34,18 @@ class Trigger extends Api
     }
 
     /**
+     * Assigns a trigger to a step.
+     * 
      * @url POST /:prj_uid/activity/:act_uid/step/:step_uid/trigger
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $step_uid
      * @param string $act_uid
      * @param string $prj_uid
      * @param StepTriggerPostStructure $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostActivityStepTrigger($step_uid, $act_uid, $prj_uid, StepTriggerPostStructure $request_data = null)
     {
@@ -122,13 +126,17 @@ class Trigger extends Api
     }
 
     /**
+     * Assigns a trigger to the "Assignment" or "Routing" step section of an activity.
+     * 
      * @url POST /:prj_uid/activity/:act_uid/step/trigger
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $act_uid
      * @param string $prj_uid
      * @param StepAssignTaskTriggerPostStructure $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostActivityStepAssignTaskTrigger($act_uid, $prj_uid, StepAssignTaskTriggerPostStructure $request_data = null)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/CaseScheduler.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/CaseScheduler.php
index 750becc0a..648cb0555 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/CaseScheduler.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/CaseScheduler.php
@@ -51,12 +51,16 @@ class CaseScheduler extends Api
     }
 
     /**
+     * Creates a new Case Scheduler. 
+     * 
      * @url POST /:prjUid/case-scheduler
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prjUid {@min 32} {@max 32}
      * @param CaseSchedulerStructure $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostProjectCaseScheduler($prjUid, CaseSchedulerStructure $request_data =  null)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/CaseTrackerObject.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/CaseTrackerObject.php
index 6d1e4b1b6..0ebcdf384 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/CaseTrackerObject.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/CaseTrackerObject.php
@@ -31,16 +31,20 @@ class CaseTrackerObject extends Api
     }
 
     /**
+     * Assigns an object (Dynaform, Input Document, Output Document) to a case tracker.
+     * 
      * @url POST /:prj_uid/case-tracker/object
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid       {@min 32}{@max 32}
      * @param array  $request_data
      * @param string $cto_type_obj  {@from body}{@choice DYNAFORM,INPUT_DOCUMENT,OUTPUT_DOCUMENT}{@required true}
      * @param string $cto_uid_obj   {@from body}{@min 32}{@max 32}{@required true}
      * @param string $cto_condition {@from body}
      * @param int    $cto_position  {@from body}{@min 1}
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostCaseTrackerObject(
         $prj_uid,
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/DataBaseConnection.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/DataBaseConnection.php
index 5750556d7..16392eb38 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/DataBaseConnection.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/DataBaseConnection.php
@@ -55,9 +55,10 @@ class DataBaseConnection extends Api
     }
 
     /**
+     * Tests a database connection with the provided settings.
+     * 
      * @url POST /:prj_uid/database-connection/test
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * 
      * @param string $prj_uid {@min 1} {@max 32}
      * @param array $request_data
      * @param string $dbs_type {@from body} {@required true}
@@ -68,6 +69,9 @@ class DataBaseConnection extends Api
      * @param string $dbs_password {@from body}
      * @param string $dbs_description {@from body}
      * @return array
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostTestDataBaseConnection(
         $prj_uid,
@@ -91,9 +95,11 @@ class DataBaseConnection extends Api
     }
 
     /**
+     * Creates a new database connection.
+     * 
      * @url POST /:prj_uid/database-connection
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid {@min 1} {@max 32}
      * @param array $request_data
      * @param string $dbs_type {@from body} {@required true}
@@ -104,7 +110,9 @@ class DataBaseConnection extends Api
      * @param string $dbs_password {@from body}
      * @param string $dbs_description {@from body}
      * @return array
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostDataBaseConnection(
         $prj_uid,
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/DynaForm.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/DynaForm.php
index a59511fca..c5696cba0 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/DynaForm.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/DynaForm.php
@@ -38,12 +38,16 @@ class DynaForm extends Api
     }
     
     /**
+     * Create dynaform.
+     * 
      * @url POST /:prj_uid/dynaform
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostDynaForm($prj_uid, $request_data)
     {
@@ -137,11 +141,15 @@ class DynaForm extends Api
     }
 
     /**
+     * Upload language for dynaform.
+     * 
      * @url POST /:prj_uid/dynaform/:dyn_uid/upload-language
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * 
      * @param string $dyn_uid {@min 32}{@max 32}
      * @param string $prj_uid {@min 32}{@max 32}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostDynaFormLanguage($dyn_uid, $prj_uid)
     {
@@ -155,11 +163,15 @@ class DynaForm extends Api
     }
 
     /**
+     * Delete language for dynaform.
+     * 
      * @url POST /:prj_uid/dynaform/:dyn_uid/delete-language/:lang
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * 
      * @param string $dyn_uid {@min 32}{@max 32}
      * @param string $prj_uid {@min 32}{@max 32}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doDeleteDynaFormLanguage($dyn_uid, $prj_uid, $lang)
     {
@@ -190,12 +202,16 @@ class DynaForm extends Api
     }
 
     /**
+     * DynaForm History.
+     * 
      * @url POST /:prj_uid/dynaform/:dyn_uid/history
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * 
      * @param string $dyn_uid {@min 32}{@max 32}
      * @param string $prj_uid {@min 32}{@max 32}
      * @param array  $request_data
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doGetDynaFormHistory($dyn_uid, $prj_uid, $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/EmailEvent.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/EmailEvent.php
index 7efb26b8e..b441a117d 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/EmailEvent.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/EmailEvent.php
@@ -65,9 +65,11 @@ class EmailEvent extends Api
     
     /**
      * @url POST /:prj_uid/email-event
+     * 
+     * @param string $prj_uid {@min 1} {@max 32}
+     * 
      * @access protected
      * @class AccessControl {@permission PM_FACTORY}
-     * @param string $prj_uid {@min 1} {@max 32}
      */
     public function doPostEmailEvent($prj_uid, array $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/FilesManager.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/FilesManager.php
index 7bd6012f5..823c6c74d 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/FilesManager.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/FilesManager.php
@@ -37,12 +37,16 @@ class FilesManager extends Api
     }
 
     /**
+     * Creates a file in the File Manager.
+     * 
      * @url POST /:prj_uid/file-manager
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * 
      * @param string $prj_uid {@min 32} {@max 32}
      * @param ProcessFilesManagerStructurePost $request_data
      * @param string $prf_content
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostProcessFilesManager($prj_uid, ProcessFilesManagerStructurePost $request_data, $prf_content=null)
     {
@@ -62,11 +66,15 @@ class FilesManager extends Api
     }
 
     /**
+     * Uploads a document to the File Manager.
+     * 
      * @url POST /:prj_uid/file-manager/:prf_uid/upload
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * 
      * @param string $prj_uid {@min 32} {@max 32}
      * @param string $prf_uid {@min 32} {@max 32}
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostProcessFilesManagerUpload($prj_uid, $prf_uid)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/InputDocument.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/InputDocument.php
index d061eca15..b88fb893c 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/InputDocument.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/InputDocument.php
@@ -33,12 +33,16 @@ class InputDocument extends Api
     }
 
     /**
+     * Create a new Input Document in a project.
+     * 
      * @url POST /:prj_uid/input-document
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostInputDocument($prj_uid, $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageEventDefinition.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageEventDefinition.php
index 3dc3fc5ef..80199cc76 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageEventDefinition.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageEventDefinition.php
@@ -80,12 +80,16 @@ class MessageEventDefinition extends Api
     }
 
     /**
+     * Create message event definition.
+     * 
      * @url POST /:prj_uid/message-event-definition
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostMessageEventDefinition($prj_uid, array $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageType.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageType.php
index 84cca6360..f66f26b5e 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageType.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageType.php
@@ -65,12 +65,16 @@ class MessageType extends Api
     }
 
     /**
+     * Create message type
+     * 
      * @url POST /:prj_uid/message-type
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostMessageType($prj_uid, array $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageType/Variable.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageType/Variable.php
index f75278d8b..5b658adcd 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageType/Variable.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/MessageType/Variable.php
@@ -68,12 +68,14 @@ class Variable extends Api
 
     /**
      * @url POST /:prj_uid/message-type/:msgt_uid/variable
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param string $msgt_uid     {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostMessageTypeVariable($prj_uid, $msgt_uid, array $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/OutputDocuments.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/OutputDocuments.php
index 184bc27b6..1152a34a1 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/OutputDocuments.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/OutputDocuments.php
@@ -51,12 +51,16 @@ class OutputDocuments extends Api
     }
 
     /**
+     * Create a new output document for a project.
+     * 
      * @url POST /:prjUid/output-document
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prjUid {@min 32} {@max 32}
      * @param OutputDocumentStructure $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostProjectOutputDocument($prjUid, OutputDocumentStructure $request_data = null)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/ProcessPermissions.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/ProcessPermissions.php
index 9a67ddbd9..394b06e4e 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/ProcessPermissions.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/ProcessPermissions.php
@@ -58,9 +58,11 @@ class ProcessPermissions extends Api
     }
 
     /**
+     * Creates a new Process Permission for a project.
+     * 
      * @url POST /:prj_uid/process-permission/
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid {@min 1} {@max 32}
      * @param array $request_data
      * @param string $usr_uid {@from body} {@min 1} {@max 32}
@@ -75,7 +77,9 @@ class ProcessPermissions extends Api
      * @param string $inputs {@from body}
      * @param string $outputs {@from body}
      * @return array
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostProcessPermission(
         $prj_uid,
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/ProcessSupervisors.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/ProcessSupervisors.php
index a7f9f8ff1..752298385 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/ProcessSupervisors.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/ProcessSupervisors.php
@@ -234,13 +234,17 @@ class ProcessSupervisors extends Api
     }
 
     /**
+     * Assign a user or group as a process supervisor.
+     * 
      * @url POST /:prjUid/process-supervisor
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prjUid {@min 32} {@max 32}
      * @param string $usr_uid {@min 32} {@max 32}
      * @param string $pu_type {@choice SUPERVISOR,GROUP_SUPERVISOR}
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostProcessSupervisor($prjUid, $usr_uid, $pu_type)
     {
@@ -257,13 +261,17 @@ class ProcessSupervisors extends Api
     }
 
     /**
+     * Assigns a Dynaform to a Process Supervisor.
+     * 
      * @url POST /:prjUid/process-supervisor/dynaform
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prjUid {@min 32} {@max 32}
      * @param string $dyn_uid {@min 32} {@max 32}
      * @param int $pud_position
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostProcessSupervisorDynaform($prjUid, $dyn_uid, $pud_position = null)
     {
@@ -280,13 +288,17 @@ class ProcessSupervisors extends Api
     }
 
     /**
+     * Assigns an input document to a Process Supervisor.
+     * 
      * @url POST /:prjUid/process-supervisor/input-document
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prjUid {@min 32} {@max 32}
      * @param string $inp_doc_uid {@min 32} {@max 32}
      * @param int $pui_position
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostProcessSupervisorInputDocument($prjUid, $inp_doc_uid, $pui_position = null)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/ProjectUsers.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/ProjectUsers.php
index 72154adda..8512903ba 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/ProjectUsers.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/ProjectUsers.php
@@ -70,12 +70,16 @@ class ProjectUsers extends Api
     }
 
     /**
+     * Return the user that can start a task.
+     * 
      * @url POST /:prj_uid/ws/user/can-start-task
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * 
      * @param string $prj_uid {@min 32} {@max 32}
      * @param string $act_uid {@min 32} {@max 32}
      * @param wsUserCanStartTaskStructure $request_data
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostProjectWsUserCanStartTask($prj_uid, $act_uid = null, wsUserCanStartTaskStructure $request_data =  null)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/ReportTable.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/ReportTable.php
index 30e7865e0..d5fbb09ee 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/ReportTable.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/ReportTable.php
@@ -95,9 +95,11 @@ class ReportTable extends Api
     }
 
     /**
+     * Creates a new Report Table.
+     * 
      * @url POST /:prj_uid/report-table
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid {@min 1} {@max 32}
      * @param array $request_data
      * @param string $rep_tab_name {@from body}
@@ -106,7 +108,9 @@ class ReportTable extends Api
      * @param string $rep_tab_type {@from body} {@choice NORMAL,GRID}
      * @param string $rep_tab_grid {@from body}
      * @return array
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostReportTable(
         $prj_uid,
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/ScriptTask.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/ScriptTask.php
index a9b57fc94..0483cfb42 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/ScriptTask.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/ScriptTask.php
@@ -80,12 +80,16 @@ class ScriptTask extends Api
     }
 
     /**
+     * Create script task for a project.
+     * 
      * @url POST /:prj_uid/script-task
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostScriptTask($prj_uid, array $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/TimerEvent.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/TimerEvent.php
index 2a53031c3..85aebb5c6 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/TimerEvent.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/TimerEvent.php
@@ -86,12 +86,16 @@ class TimerEvent extends Api
     }
 
     /**
+     * Create timer event for a project.
+     * 
      * @url POST /:prj_uid/timer-event
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostTimerEvent($prj_uid, array $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/Trigger.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/Trigger.php
index 58616ee39..62d407352 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/Trigger.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/Trigger.php
@@ -55,9 +55,11 @@ class Trigger extends Api
     }
 
     /**
+     * Create a new trigger in a project.
+     * 
      * @url POST /:projectUid/trigger
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $projectUid {@min 1} {@max 32}
      * @param array $request_data
      * @param string $tri_title {@from body} {@min 1}
@@ -66,7 +68,9 @@ class Trigger extends Api
      * @param string $tri_webbot {@from body}
      * @param string $tri_param {@from body}
      * @return array
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostTrigger($projectUid, $request_data, $tri_title, $tri_description = '', $tri_type = 'SCRIPT', $tri_webbot = '', $tri_param = '')
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/TriggerWizard.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/TriggerWizard.php
index 0735963c2..26933f187 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/TriggerWizard.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/TriggerWizard.php
@@ -66,14 +66,18 @@ class TriggerWizard extends Api
     }
 
     /**
+     * Create Trigger for a Process
+     * 
      * @url POST /:prj_uid/trigger-wizard/:lib_name/:fn_name
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param string $lib_name
      * @param string $fn_name
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostTriggerWizard($prj_uid, $lib_name, $fn_name, $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/Variable.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/Variable.php
index 0321079cd..4fa21db77 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/Variable.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/Variable.php
@@ -48,12 +48,16 @@ class Variable extends Api
     }
 
     /**
+     * Create a process variable.
+     * 
      * @url POST /:prj_uid/process-variable
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostVariable($prj_uid, $request_data)
     {
@@ -109,12 +113,18 @@ class Variable extends Api
     }
 
     /**
+     * Executes an SQL query of a dependent field, such as a dropdown box, checkgroup 
+     * or radiogroup, that uses an SQL query with one or more dynamic variables 
+     * to populate its list of options.
+     * 
      * @url POST /:prj_uid/process-variable/:var_name/execute-query
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY, PM_CASES}
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param string $var_name
      * @param array  $request_data
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY, PM_CASES}
      */
     public function doPostVariableExecuteSql($prj_uid, $var_name = '', $request_data = array())
     {
@@ -132,12 +142,18 @@ class Variable extends Api
     }
 
     /**
+     * Queries the options in a suggest box, dropdown box, checkgroup or radiogroup, 
+     * which uses an SQL query to populate its list of options (or uses a datasource 
+     * which is "array variable" in version 3.0.1.8 or later).
+     * 
      * @url POST /:prj_uid/process-variable/:var_name/execute-query-suggest
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY, PM_CASES}
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param string $var_name
      * @param array  $request_data
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY, PM_CASES}
      */
     public function doPostVariableExecuteSqlSuggest($prj_uid, $var_name, $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/WebEntry.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/WebEntry.php
index 3dd31a800..203994a96 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/WebEntry.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/WebEntry.php
@@ -71,12 +71,16 @@ class WebEntry extends Api
     }
 
     /**
+     * Creates a new Web Entry using the method "PHP pages with Web Services".
+     * 
      * @url POST /:prj_uid/web-entry
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostWebEntry($prj_uid, array $request_data)
     {
diff --git a/workflow/engine/src/ProcessMaker/Services/Api/Project/WebEntryEvent.php b/workflow/engine/src/ProcessMaker/Services/Api/Project/WebEntryEvent.php
index 29a8cec15..56e032837 100644
--- a/workflow/engine/src/ProcessMaker/Services/Api/Project/WebEntryEvent.php
+++ b/workflow/engine/src/ProcessMaker/Services/Api/Project/WebEntryEvent.php
@@ -88,12 +88,16 @@ class WebEntryEvent extends Api
     }
 
     /**
+     * Create web entry event for a project.
+     * 
      * @url POST /:prj_uid/web-entry-event
-     * @access protected
-     * @class AccessControl {@permission PM_FACTORY}
+     * @status 201
+     * 
      * @param string $prj_uid      {@min 32}{@max 32}
      * @param array  $request_data
-     * @status 201
+     * 
+     * @access protected
+     * @class AccessControl {@permission PM_FACTORY}
      */
     public function doPostWebEntryEvent($prj_uid, array $request_data)
     {