create uri workflow
/members/{member}/groups/{group}/uris/{uri}/workflow [POST]
API Support | Available since | Last updated | Output |
---|---|---|---|
supported | 5.6900 | 5.9300 | xml, json |
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.
Note
Workflow tasks might not be available in groups a document is shared to unless they were created after the document was shared.
Parameters
Name | Description | Required | Type | Default value |
---|---|---|---|---|
assignedto | ID of assigned member for workflow ("" means blank value) | no | string | previous workflow assigned member |
description | The workflow content | no | string | |
due | The workflow due date and time in ISO-8601 format. e.g. 2010-10-25T18:00:00+11:00 ("" means blank value) | no | datetime | previous workflow due date |
labels | Label values for workflow e.g. Important, Typo | no | string | |
notify | Send notification flag[silent|minimal|normal|announce] | no | notify | silent |
notify-async | Whether emails should be sent asynchronously (for slow email servers) | no | boolean | false |
priority | Priority for workflow e.g. High , Medium , Low ("" means blank value) | no | string | previous workflow priority |
status | Status for workflow e.g.Initiated , In Progress , Complete , Approved , Suspended , Terminated (required if URI is a folder or for first workflow) | maybe | string | previous 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
Code | Cause / Description |
---|---|
0x120E | The due date is invalid |
0x1027 | The assignedto Member ID is invalid |
0x122E | The labels parameter is invalid |
0x122F | The priority parameter is invalid |
0x1230 | The status parameter is invalid |
Created on , last edited on