Create/update datePOST

Description

Create/update date. If no date exists for given targetColumnId it is created, otherwise it is replaced. If targetColumnId is omitted, the date without a target column is created or replaced.

Permissions

The API token needs the Edit tasks permission.

Request format

curl -X POST https://kanbanflow.com/api/v1/tasks/<TASK_ID>/dates -H "Content-type: application/json" -d '{ "<PROPERTY_1>": <PROPERTY_VALUE_1>, "<PROPERTY_2>": <PROPERTY_VALUE_2>, ... "<PROPERTY_N>": <PROPERTY_VALUE_N> }'

Example request (with target column)

curl -X POST https://kanbanflow.com/api/v1/tasks/T3s6UGyzY/dates -H "Content-type: application/json"
 -d '{ "dueTimestamp": "2023-03-01T12:00:00Z", "dueTimestampLocal": "2023-03-01T13:00:00+01:00", "targetColumnId": "COxkPjd0wra4" }'

Example request (any archived column)

curl -X POST https://kanbanflow.com/api/v1/tasks/T3s6UGyzY/dates -H "Content-type: application/json"
 -d '{ "dueTimestamp": "2023-03-01T12:00:00Z", "dueTimestampLocal": "2023-03-01T13:00:00+01:00" }'

Valid properties

Property	Type	Comment
dateType	String	The type of the date. Only valid value is "dueDate". More types may be added in the future. Default: "dueDate".
status	String	The status of the date. Either "active" or "done". Default: "active".
dueTimestamp	String	Required. The UTC timestamp when the task is due for the target column.
dueTimestampLocal	String	The user's local timestamp when the task is due for the target column. Used for email reminders. Default: dueTimestamp.
targetColumnId	String	The ID of the column that the task should reach before it is due. See Get board for column IDs. If omitted (or null), the date is done when the task reaches any archived column.