# Web API **URL:** https://discuss.workflowgen.com/c/development/web-api/18.md [Latest](https://discuss.workflowgen.com/latest.md) · [Categories](https://discuss.workflowgen.com/categories.md) · [Tags](https://discuss.workflowgen.com/tags.md) --- ## [About the Web API category](https://discuss.workflowgen.com/t/about-the-api-category/33)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [November 16, 2016, 5:39pm UTC](https://discuss.workflowgen.com/t/about-the-api-category/33 "2016-11-16T17:39:46Z")
Discuss the WorkflowGen API. --- ## [WorkflowGen.My & WorkflowGen Web Controls strong naming](https://discuss.workflowgen.com/t/workflowgen-my-workflowgen-web-controls-strong-naming/1763)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [December 28, 2020, 6:09pm UTC](https://discuss.workflowgen.com/t/workflowgen-my-workflowgen-web-controls-strong-naming/1763 "2020-12-28T18:09:02Z")
Overview As of version 3.2.0, the WorkflowGen.My and WorkflowGen Web Controls assemblies are no longer strong named in order to allow non-specific version dependency when referenced by other applications such as custom a… --- ## [Testing Webhooks with Postman](https://discuss.workflowgen.com/t/testing-webhooks-with-postman/2050)
**Author:** [@eddy.daouk](https://discuss.workflowgen.com/u/eddy.daouk)\ **Replies:** 0\ **Last updated:** [April 26, 2022, 10:20pm UTC](https://discuss.workflowgen.com/t/testing-webhooks-with-postman/2050 "2022-04-26T22:20:55Z")
In this article, we will go through the following steps to successfully test WorkflowGen’s Webhooks API using Postman: IIS Setup Process Setup Incoming Webhook application setup in WorkflowGen Import the Webh… --- ## [GetProcessInstanceList Search lost when limited supervisor](https://discuss.workflowgen.com/t/getprocessinstancelist-search-lost-when-limited-supervisor/1932)
**Author:** [@ParadimeWeb](https://discuss.workflowgen.com/u/ParadimeWeb)\ **Replies:** 0\ **Last updated:** [September 2, 2021, 6:00pm UTC](https://discuss.workflowgen.com/t/getprocessinstancelist-search-lost-when-limited-supervisor/1932 "2021-09-02T18:00:55Z")
I have a process with a participant, APPROVER, with limited supervisor permissions. When the requester of a request is in the APPROVER participant, they lose the ability to Search using the GetProcessInstanceList meth… --- ## [System.Data.DuplicateNameException: A column named 'APPROVAL4\_dtVacationEndDate' already belongs to this DataTable](https://discuss.workflowgen.com/t/system-data-duplicatenameexception-a-column-named-approval4-dtvacationenddate-already-belongs-to-this-datatable/1799)
**Author:** [@Silini](https://discuss.workflowgen.com/u/Silini)\ **Replies:** 0\ **Last updated:** [February 1, 2021, 6:54pm UTC](https://discuss.workflowgen.com/t/system-data-duplicatenameexception-a-column-named-approval4-dtvacationenddate-already-belongs-to-this-datatable/1799 "2021-02-01T18:54:35Z")
Hi everybody. I hope all doing well. last time I tried to apply an action to an activityInstance using wfgen web service as below: POST /wfgen/ws/ProcessesRuntime.asmx/CompleteWebFormActivityInstance?impersonateuserna… --- ## [Web Services API: Get Process Data and Form Data Values](https://discuss.workflowgen.com/t/web-services-api-get-process-data-and-form-data-values/322)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [February 20, 2014, 6:39am UTC](https://discuss.workflowgen.com/t/web-services-api-get-process-data-and-form-data-values/322 "2014-02-20T06:39:40Z")
Overview The GetProcessInstanceContext and GetProcessInstanceFormData web methods allow you to retrieve process data and form data values of a specified request. The web method parameters are: processInstanceId: The… --- ## [Web Service API / GraphQL : How to get a list of filtered groups](https://discuss.workflowgen.com/t/web-service-api-graphql-how-to-get-a-list-of-filtered-groups/1737)
**Author:** [@nvarlet](https://discuss.workflowgen.com/u/nvarlet)\ **Replies:** 0\ **Last updated:** [December 18, 2020, 4:04pm UTC](https://discuss.workflowgen.com/t/web-service-api-graphql-how-to-get-a-list-of-filtered-groups/1737 "2020-12-18T16:04:58Z")
Hello, I’m trying to get the full list of groups with name like “GRP\_\*”. I can see that there is no webservice for that. WS getGroup is for only one known group. I tried graphQL but there is no filter available so I … --- ## [Difference between a web procedure and an asynchronous web procedure](https://discuss.workflowgen.com/t/difference-between-a-web-procedure-and-an-asynchronous-web-procedure/307)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [April 6, 2007, 6:34pm UTC](https://discuss.workflowgen.com/t/difference-between-a-web-procedure-and-an-asynchronous-web-procedure/307 "2007-04-06T18:34:46Z")
Principle of web procedures WorkflowGen calls the web procedure and waits for the response. Since WorkflowGen is still connected, if the response takes too much time to reply a time out will occur. WorkflowGen calls t… --- ## [Web Services API: Assignment management](https://discuss.workflowgen.com/t/web-services-api-assignment-management/320)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [February 20, 2014, 5:36am UTC](https://discuss.workflowgen.com/t/web-services-api-assignment-management/320 "2014-02-20T05:36:04Z")
Since version 5.6.4, the following web methods are available: AssignActivityInstance CanAssignActivityInstance CanAssignUserToActivityInstance CancelActivityInstanceAssignment CanCancelActivityInstanceAssi… --- ## [Web Services API: Cancel a request](https://discuss.workflowgen.com/t/web-services-api-cancel-a-request/321)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [February 20, 2014, 5:45am UTC](https://discuss.workflowgen.com/t/web-services-api-cancel-a-request/321 "2014-02-20T05:45:47Z")
Since WorkflowGen version 5.6.4 the following web methods are available: CancelProcessInstance CanCancelProcessInstance The parameters of those web methods are: processInstanceId: The request ID isSuperUse… --- ## [Web Services API: Http 401 error](https://discuss.workflowgen.com/t/web-services-api-http-401-error/323)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [April 15, 2014, 11:05pm UTC](https://discuss.workflowgen.com/t/web-services-api-http-401-error/323 "2014-04-15T23:05:03Z")
Issue When trying to call a WorkflowGen web service (\\wfgen\\ws\\ProcessesRuntime.asmx), I receive an HTTP 401 error code. Solution The \\wfgen\\ws folder must be secured by using HTTP Basic authentication (secured with SSL… --- ## [Web Services API: Retrieve a list of actions to do filtered on the process data values](https://discuss.workflowgen.com/t/web-services-api-retrieve-a-list-of-actions-to-do-filtered-on-the-process-data-values/324)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [April 15, 2014, 11:13pm UTC](https://discuss.workflowgen.com/t/web-services-api-retrieve-a-list-of-actions-to-do-filtered-on-the-process-data-values/324 "2014-04-15T23:13:01Z")
Question We would like to retrieve the list of actions to do filtered on some process data values (e.g: AMOUNT, COMPANY) Solution “GetActivityInstanceList” web method doesn’t support parameters to filter the list of a… --- ## [Web Services API: CompleteActivityInstance error : System.NullReferenceException: Object reference not set to an instance of an object](https://discuss.workflowgen.com/t/web-services-api-completeactivityinstance-error-system-nullreferenceexception-object-reference-not-set-to-an-instance-of-an-object/325)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [June 14, 2014, 2:53am UTC](https://discuss.workflowgen.com/t/web-services-api-completeactivityinstance-error-system-nullreferenceexception-object-reference-not-set-to-an-instance-of-an-object/325 "2014-06-14T02:53:08Z")
Issue When calling the complete activity instance web service I get the following error: System.NullReferenceException: Object reference not set to an instance of an object. at Advantys.My.Globalization.TimeZoneInform… --- ## [Web Services API: RaiseException: What is the parameter value for exceptionName in RaiseException API method](https://discuss.workflowgen.com/t/web-services-api-raiseexception-what-is-the-parameter-value-for-exceptionname-in-raiseexception-api-method/313)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [October 5, 2013, 5:51am UTC](https://discuss.workflowgen.com/t/web-services-api-raiseexception-what-is-the-parameter-value-for-exceptionname-in-raiseexception-api-method/313 "2013-10-05T05:51:01Z")
The possible values are CANCEL, ERROR, TIMEOUT, and ASSIGNMENT\_ERROR. Since WorkflowGen version 5.6.4, the exceptionMessage parameter is used with the ERROR exception to provide more details about the error in the actio… --- ## [Is there a way to mass cancel workflow requests?](https://discuss.workflowgen.com/t/is-there-a-way-to-mass-cancel-workflow-requests/311)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [July 20, 2013, 10:24pm UTC](https://discuss.workflowgen.com/t/is-there-a-way-to-mass-cancel-workflow-requests/311 "2013-07-20T22:24:17Z")
There’s no standard mass request cancellation feature in WorkflowGen, and it may be a bit risky to provide such a function. However, there is a way to do this by creating a script that does an HTTP post of the following… --- ## [Web Service: API: Performance: Limit the process data to be retrieved](https://discuss.workflowgen.com/t/web-service-api-performance-limit-the-process-data-to-be-retrieved/314)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [December 4, 2013, 5:26am UTC](https://discuss.workflowgen.com/t/web-service-api-performance-limit-the-process-data-to-be-retrieved/314 "2013-12-04T05:26:28Z")
By default, the GetProcessInstanceList and GetActivityInstanceList web methods retrieve all the process data associated to the requests/actions. If you don’t need process data values, you just have to add a SOAP header … --- ## [Web Services API: SoapException "Security: You are not authorized to use this web service"](https://discuss.workflowgen.com/t/web-services-api-soapexception-security-you-are-not-authorized-to-use-this-web-service/316)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [December 20, 2013, 1:45am UTC](https://discuss.workflowgen.com/t/web-services-api-soapexception-security-you-are-not-authorized-to-use-this-web-service/316 "2013-12-20T01:45:05Z")
Certain WorkflowGen web service methods require an additional configuration setting to be called by a user. In the \\wfgen\\ws\\web.config file, edit the following key to authorize WorkflowGen administrators to use the sec… --- ## [Web Services API: StartProcess: Launch a process on behalf of another user](https://discuss.workflowgen.com/t/web-services-api-startprocess-launch-a-process-on-behalf-of-another-user/318)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [December 20, 2013, 7:58am UTC](https://discuss.workflowgen.com/t/web-services-api-startprocess-launch-a-process-on-behalf-of-another-user/318 "2013-12-20T07:58:02Z")
About The StartProcess web method supports impersonation, and is available as of WorkflowGen version 5.6.3. It allows an authorized user to launch a process on behalf of another user with this web method call. This featu… --- ## [Web service: How to get associated data of a request and download the associated attachments](https://discuss.workflowgen.com/t/web-service-how-to-get-associated-data-of-a-request-and-download-the-associated-attachments/309)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [July 20, 2013, 10:07pm UTC](https://discuss.workflowgen.com/t/web-service-how-to-get-associated-data-of-a-request-and-download-the-associated-attachments/309 "2013-07-20T22:07:54Z")
If you are a process supervisor, manager, or administrator, you can use the web API to get information on a specific request using the URLs below. These examples use request 17. If request #17 is still ongoing: http://… --- ## [Web Service: What is the best way to cancel an action?](https://discuss.workflowgen.com/t/web-service-what-is-the-best-way-to-cancel-an-action/310)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [July 20, 2013, 10:14pm UTC](https://discuss.workflowgen.com/t/web-service-what-is-the-best-way-to-cancel-an-action/310 "2013-07-20T22:14:07Z")
Issue What is the best way to cancel an action (CompleteActivityInstance or RaiseCancelExceptionOnActivityInstance/ RaiseCancelExceptionOnActivityInstanceByName method)? Solution Use the RaiseCancelExceptionOnActivityIn… --- ## [How to invoke a WorkflowGen API using .NET code](https://discuss.workflowgen.com/t/how-to-invoke-a-workflowgen-api-using-net-code/308)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [February 3, 2009, 10:35am UTC](https://discuss.workflowgen.com/t/how-to-invoke-a-workflowgen-api-using-net-code/308 "2009-02-03T10:35:00Z")
Note: APIs are only available as of WorkflowGen version 5.1. Before invoking a WorkflowGen API using .NET code, first verify that you have access to the APIs by doing the following: Open a new web browser and connect… --- ## [How to launch a new request with context parameters from an external application via the web service API using SOAP](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-the-web-service-api-using-soap/327)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [October 8, 2015, 7:57am UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-the-web-service-api-using-soap/327 "2015-10-08T07:57:39Z")
This procedure lets you launch a new process from another application using HTTP parameters. It applies to WorkflowGen versions 5 and 6. Follow the instructions below for your version of WorkflowGen. Note: For security … --- ## [How to add user delegations for all processes and participants via API](https://discuss.workflowgen.com/t/how-to-add-user-delegations-for-all-processes-and-participants-via-api/328)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [January 1, 2016, 5:06am UTC](https://discuss.workflowgen.com/t/how-to-add-user-delegations-for-all-processes-and-participants-via-api/328 "2016-01-01T05:06:02Z")
You can add delegations for all processes and participants (rather than for single processes and participants) to a user via the API by using the RuntimeService.AddDelegation method. To do this, set the processId and pa… --- ## [Web Services API: Update Process Instance Data](https://discuss.workflowgen.com/t/web-services-api-update-process-instance-data/317)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [December 20, 2013, 7:14am UTC](https://discuss.workflowgen.com/t/web-services-api-update-process-instance-data/317 "2013-12-20T07:14:28Z")
As of WorkflowGen version 5.6.3, you can use the UpdateProcessInstanceData web method to update associated data to a request in progress from an external application. Security The UpdateProcessInstanceData web method is… --- ## [Delegations: Is there any possibility to add Delegations via Web Service?](https://discuss.workflowgen.com/t/delegations-is-there-any-possibility-to-add-delegations-via-web-service/312)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 0\ **Last updated:** [July 28, 2013, 4:16am UTC](https://discuss.workflowgen.com/t/delegations-is-there-any-possibility-to-add-delegations-via-web-service/312 "2013-07-28T04:16:28Z")
You can use the WorkflowGen Web Service API method to add a new delegation for the current connected user: http://server:port/wfgen/ws/processesruntime.asmx?op=AddDelegation If needed, you can specify a BeginDate and a… --- ## [Web Services API: User Impersonation with ImpersonateUsername parameter](https://discuss.workflowgen.com/t/web-services-api-user-impersonation-with-impersonateusername-parameter/319)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 2\ **Last updated:** [June 18, 2019, 10:19pm UTC](https://discuss.workflowgen.com/t/web-services-api-user-impersonation-with-impersonateusername-parameter/319 "2019-06-18T22:19:25Z")
As of WorkflowGen version 5.6.3, all user context-based API web methods support impersonation. This means that an authorized user can call a web method on behalf of another user. Security The impersonation feature is r… --- ## [Web Services API: WorkflowContext specifications and usage](https://discuss.workflowgen.com/t/web-services-api-workflowcontext-specifications-and-usage/315)
**Author:** [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\ **Replies:** 2\ **Last updated:** [March 20, 2019, 3:00pm UTC](https://discuss.workflowgen.com/t/web-services-api-workflowcontext-specifications-and-usage/315 "2019-03-20T15:00:34Z")
The WorkflowGen Web Services API uses WorkflowContext data structure in important web methods such as: CompleteActivityInstance GetActivityInstanceContext StartProcess WorkflowContext is an XML data structure… --- ## [How can i find the attached file that send through API?](https://discuss.workflowgen.com/t/how-can-i-find-the-attached-file-that-send-through-api/1324)
**Author:** [@Silini](https://discuss.workflowgen.com/u/Silini)\ **Replies:** 1\ **Last updated:** [February 25, 2019, 8:52am UTC](https://discuss.workflowgen.com/t/how-can-i-find-the-attached-file-that-send-through-api/1324 "2019-02-25T08:52:47Z")
Hi everybody. i’m using the web service to create an action on wfg that contains attachment. my question is where is the physical location of the attached file on wfg app server? FYI below is the context that i used t… --- ## [How to launch a request with a FILE using SOAP Web Services](https://discuss.workflowgen.com/t/how-to-launch-a-request-with-a-file-using-soap-web-services/1301)
**Author:** [@qpomarel](https://discuss.workflowgen.com/u/qpomarel)\ **Replies:** 0\ **Last updated:** [February 6, 2019, 8:24pm UTC](https://discuss.workflowgen.com/t/how-to-launch-a-request-with-a-file-using-soap-web-services/1301 "2019-02-06T20:24:44Z")
Configure the process To send a file to a process, perform the following steps: Enable Sub-process mode for the process and set Access level to Public. Create a file data (such as REQUEST\_FILE) and select I… --- ## [How to use WorkflowGen Web Services API to send a file](https://discuss.workflowgen.com/t/how-to-use-workflowgen-web-services-api-to-send-a-file/1300)
**Author:** [@Silini](https://discuss.workflowgen.com/u/Silini)\ **Replies:** 4\ **Last updated:** [February 7, 2019, 2:32pm UTC](https://discuss.workflowgen.com/t/how-to-use-workflowgen-web-services-api-to-send-a-file/1300 "2019-02-07T14:32:15Z")
Hi everybody. I’m trying to create a new request that contains a file as an attachment of the context as below : \ \ \Request\_txtRequesterUsername\ \TEXT\ \