Sign in
One-Off Tasks

Create a one-off task

Creates a new one-off task, optionally linked to a workflow run.

post/work/tasks

Request body

namestring required

Display name.

descriptionstring

Optional long-form description.

dueDatestring date-time

Due date. ISO-8601 UTC.

requiredboolean required

When true, the form field must have a value before its task can be completed.

linkedWorkflowRunIdstring
assigneeEmailsstring[]

Response

Example response

{
  "data": {
    "id": "vcbdSaOyh6lth1VHzJRO8Q",
    "createdBy": {
      "id": "oU4EEGRPtELpR1x1YUJMeQ",
      "email": "jane.doe@example.com",
      "username": "Jane Doe"
    },
    "updatedBy": {
      "id": "oU4EEGRPtELpR1x1YUJMeQ",
      "email": "jane.doe@example.com",
      "username": "Jane Doe"
    },
    "assignments": [
      {
        "user": {
          "id": "oU4EEGRPtELpR1x1YUJMeQ",
          "email": "jane.doe@example.com",
          "username": "Jane Doe"
        }
      }
    ],
    "linkedWorkflowRun": {
      "id": "ntpB6HYW7f-DvzpORfNEiQ",
      "templateId": "ntpB6HYW7f-DvzpORfNEiQ"
    },
    "links": [
      {
        "href": "https://api.process.st/api/v1.1/resource/XXX"
      }
    ]
  },
  "links": [
    {
      "href": "https://api.process.st/api/v1.1/resource/XXX"
    }
  ]
}

Changes