Skip to main content

 Services

Web services from /about to /webhooks

create uri workflow

/members/{member}/groups/{group}/uris/{uri}/workflow [POST]

Description

Create a new workflow.

Adds a workflow step to a URI, or if the URI is a folder, the URIs under it.

If the URI is a folder, this service starts an asynchronous process.

Workflow tasks might not be available in groups a document is shared to unless they were created after the document was shared.

Parameters

NameDescriptionRequiredTypeDefault value
assignedtoID of assigned member for workflow ("" means blank value)nostringprevious workflow assigned member
descriptionThe workflow contentnostring
dueWorkflow due date format is yyyy-MM-dd ("" means blank value)nodateprevious workflow due date
labelsLabel values for workflow e.g. Important, Typonostring
notifySend notification flag
[silent|minimal|normal|announce]
nonotifysilent
notify-asyncWhether emails should be sent asynchronously (for slow email servers)nobooleanfalse
priorityPriority for workflow e.g. High, Medium, Low ("" means blank value)nostringprevious workflow priority
statusStatus for workflow e.g.Initiated , In Progress, Complete, Approved, Suspended, Terminated (required if URI is a folder or for first workflow)maybestringprevious workflow status

Permission

Requires contributor or higher in the group.

Response

<workflow-creation [warning="[warning]"]
                   [notify-param-ignored=true"]>
  <comment id="123"
           contentrole="Workflow"
           created="2012-03-08T12:34:00+10:00"
           status="Initiated"
           due="2012-03-10T18:00:00+10:00"
           priority="High">
    <title>Cavern stolen!</title>
    <author email="alibaba@fortythieves.com.au"> ...
    </author>
    <assignedto id="123"
                date="2012-03-09T..."> ...
    </assignedto>
    <content id="789"
             type="text/plain">Please review the treasure.
    </content>
  </comment>
</workflow-creation> 

For a single URI and the following XML for a folder URI.

<workflow-creation>
  <thread ...> ... </thread>
</workflow-creation> 

Error Handling

CodeCause / Description
0x120EThe due date is invalid
0x1027The assignedto Member ID is invalid
0x122EThe labels parameter is invalid
0x122FThe priority parameter is invalid
0x1230The status parameter is invalid
Created on , last edited on