topic Re: Start a workflow via REST call in Alfresco Forum

Start a workflow via REST call

mangar — Mon, 14 Jun 2021 21:52:22 GMT

Real simple, or should be, but how do I start a workflow via REST? I have tried to POST to

/alfresco/service/api/workflow-instances/{workflow-id}
/alfresco/service/api/workflow-definitions/{workflow-id}

Both to no avail.

And is ther a better API reference than this:

https://hub.alfresco.com/t5/alfresco-content-services-hub/workflow-rest-api/ba-p/290146

Re: Start a workflow via REST call

narkuss — Tue, 15 Jun 2021 06:32:36 GMT

Hi,

You should send a POST call to <alfresco-url>/alfresco/api/-default-/public/workflow/versions/1/processes.

If you go to <alfresco-url>/api-explorer, you will see all available endpoints and their explanation. Select "workflow API" from the dropdown at the top.

An example body could be:

{
  "processDefinitionKey": "string",
  "variables": {
    "bpm_assignee": "string",
    "bpm_sendEMailNotifications": true,
    "bpm_workflowPriority": 0
  }
}

Hope it helps

Re: Start a workflow via REST call

EddieMay — Tue, 15 Jun 2021 12:57:06 GMT

Hi @mangar

There is the Activiti github examples that might be useful.

HTH,

Re: Start a workflow via REST call

mangar — Tue, 15 Jun 2021 16:12:45 GMT

Thanks for the link! I will us that a lot I am sure. but I was after the REST api.

Re: Start a workflow via REST call

mangar — Wed, 16 Jun 2021 01:46:41 GMT

@narkuss

That worked and I am unblocked so thank you. But I go to the api-exporer, and there is nothing on processes. I do a full text search on "processes" and I get nothing. Nothing on "workflow" either. How is there not one place a developer can go and get all the REST apis?

Re: Start a workflow via REST call

EddieMay — Wed, 16 Jun 2021 10:51:31 GMT

Hi @mangar

Have you tried the public API explorer? Authentication is admin/admin.