Tasks

Update a task

Partial update. Send null to clear a nullable field. Moving a task into a section whose name implies a status (e.g. "Done", "In progress", "Blocked") applies that status; completing a task stamps completed_at, moves it to the project's done column (the section named "Done" if present, else the first section whose name implies completed, e.g. "Finished" or "Shipped"), unblocks dependents and notifies watchers. Moving a completed task out of the done column reopens it like POST /tasks/{id}/reopen: status becomes blocked if any dependency is incomplete, else the section-implied status; an explicit status in the same request overrides this.

patch/tasks/{id}

Request

  • Base URL: https://tasg.app/api/v1
  • URL: https://tasg.app/api/v1/tasks/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Task id.

Request body

titlestring
descriptionstring nullable
assignee_idstring uuid nullable

Must be a member of the project.

section_idstring uuid nullable

Must belong to the task's project.

start_datestring nullable

Any value new Date() accepts; use YYYY-MM-DD.

due_datestring nullable

Any value new Date() accepts; use YYYY-MM-DD.

due_date_type'fixed' | 'relative'

relative tasks derive their due date from another task plus an offset.

relative_offset_daysinteger nullable
relative_offset_from_task_idstring uuid nullable

Anchor task for relative due dates; must be in the same project.

priority'none' | 'low' | 'medium' | 'high' | 'urgent'
status'not_started' | 'in_progress' | 'blocked' | 'completed'
positionnumber

Reorder within the section.

tag_idsstring[]

On PATCH this REPLACES the whole tag set. Duplicate ids are deduplicated; every id must be a tag of the task's workspace, else 400.

categorystring nullable
recurrence'daily' | 'weekly' | 'fortnightly' | 'monthly' nullable

Repeat rule. Completing a recurring task spawns the next occurrence exactly once: due (and start, keeping the same lead time) advanced by the rule, placed in the first not-done section, keeping assignee, priority, tags and subtasks (reset). Send null on PATCH to stop repeating.

Response

Updated.

Changes

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