Subtasks

Update a subtask

When the body sets both startDate and endDate, endDate must be >= startDate. The merged planned dates must stay inside the card's plan, which must carry both planned dates (400, details.rule CARD_HAS_NO_DATES or SUBTASK_OUT_OF_RANGE, naming the plan and the offending date); actual dates are independent.

patch/api/subtasks/{subtaskId}

Request

  • Base URL: https://tre-app.com
  • URL: https://tre-app.com/api/subtasks/{subtaskId}
  • Auth: HTTP bearer

Request body

titlestring
startDatestring date nullable
endDatestring date nullable
scheduleState'unclassified' | 'planned' | 'suspended' | 'cancelled'

Meaning of the retained schedule; one server rule on every surface. Omit it: a create with a planned date is stored as planned, one without as unclassified; on update, touching a planned date promotes unclassified to planned, clearing both planned dates resets to unclassified, any other stored state is kept. Send suspended or cancelled explicitly; a non-unclassified state with both planned dates null is refused (400 BAD_REQUEST).

actualStartDatestring date nullable

Observed start, explicitly recorded from evidence. Independent of the schedule; null means unknown, never not started.

actualEndDatestring date nullable

Observed end, explicitly recorded from evidence. May fall outside the plan. Null means unknown, never incomplete.

colorstring

Response

Success

idstring uuid required
cardIdstring uuid required
titlestring required
startDatestring date nullable required
endDatestring date nullable required
scheduleState'unclassified' | 'planned' | 'suspended' | 'cancelled' required

Meaning of the retained schedule. Unclassified means its intent has not been reviewed; suspended/cancelled retain the plan for retrospective comparison.

actualStartDatestring date nullable required

Observed start, explicitly recorded from evidence. Independent of the schedule; null means unknown, never not started.

actualEndDatestring date nullable required

Observed end, explicitly recorded from evidence. May fall outside the plan. Null means unknown, never incomplete.

orderinteger required
colorstring required
createdAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.