Post Task Attachment

Creates an attachment for a task.

Method

POST /task/{id}/attachment/create

Parameters

Path Parameters

Name Description
id The id of the task to add the attachment to.

Request Body

A multipart form submit with the following parts:

Form Part Name Content Type Description
attachment-name text/plain The name of the attachment.
attachment-description text/plain The description of the attachment.
attachment-type text/plain The type of the attachment.
url text/plain The url to the remote content of the attachment.
content text/plain The content of the attachment.

Result

A JSON object corresponding to the Attachment interface in the engine. Its properties are as follows:

Name Value Description
id String The id of the task attachment.
name String The name of the task attachment.
taskId String The id of the task to which the attachment belongs.
description String The description of the task attachment.
type String Indication of the type of content that this attachment refers to. Can be MIME type or any other indication.
url String The url to the remote content of the task attachment.
createTime String The time the variable was inserted. Default format* yyyy-MM-dd'T'HH:mm:ss.SSSZ.
removalTime String The time after which the attachment should be removed by the History Cleanup job. Default format* yyyy-MM-dd'T'HH:mm:ss.SSSZ.
rootProcessInstanceId String The process instance id of the root process instance that initiated the process containing the task.

* For further information, please see the documentation.

Response codes

Code Media type Description
200 application/json Request successful.
400 application/json The task does not exists or task id is null. No content or url to remote content exists. See the Introduction for the error response format.
403 application/json The history of the engine is disabled. See the Introduction for the error response format.

Example

Request

Post data for a new task attachment:

POST /task/aTaskId/attachment/create

------------------------------925df49a954b
Content-Disposition: form-data; name="url"

http://my-attachment-content-url.de
------------------------------925df49a954b
Content-Disposition: form-data; name="attachment-name"

attachmentName
------------------------------925df49a954b
Content-Disposition: form-data; name="attachment-description"

attachmentDescription
------------------------------925df49a954b
Content-Disposition: form-data; name="attachment-type"

attachmentType
------------------------------925df49a954b--

Response

Status 200.

{
  "links": [
    {
      "method": "GET",
      "href": "http://localhost:38080/rest-test/task/aTaskId/attachment/aTaskAttachmentId",
      "rel": "self"
    }
  ],
    "id": "attachmentId",
    "name": "attachmentName",
    "taskId": "aTaskId",
    "description": "attachmentDescription",
    "type": "attachmentType",
    "url": "http://my-attachment-content-url.de",
    "createTime":"2017-02-10T14:33:19.000+0200",
    "removalTime":"2018-02-10T14:33:19.000+0200",
    "rootProcessInstanceId": "aRootProcessInstanceId"
}

On this Page: