v1
Tasks
tasks

Update Task

Update a task.

For floor users, only allows updating tasks assigned to them.

patch/api/v1/tasks/{task_id}

Request

  • Base URL: https://api.jeevyfabrication.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.jeevyfabrication.com/api/v1/tasks/{task_id}
  • Auth: none declared

Path parameters

task_idinteger required

Request body

titlestring nullable
task_numberstring nullable
descriptionstring nullable
work_stream_idinteger nullable

Work stream this task belongs to. Set to empty string to clear.

parent_task_idinteger nullable

Parent task ID for sub-tasks. Set to empty string to clear.

equipment_idsinteger[] nullable
deadlinestring nullable

Task deadline as ISO 8601 timestamp (e.g., '2026-01-25T14:30:00Z'). Set to empty string to clear deadline.

drawing_idinteger nullable
display_orderinteger nullable
statusstring nullable
reopenReasonstring nullable

Reason for reopening a completed task. Logged to activity trail.

depends_on_task_idsinteger[] nullable

Sibling-only task IDs (same parent, or top-level in this work stream). Set to empty array to clear.

notesstring nullable
is_groupboolean nullable

Flag to indicate if this is a task group (container) or a regular task/operation.

clockInLevelstring nullable

'group' = workers clock into this group; 'individual' = clock into children separately.

estimatedHoursnumber nullable

Total man-hours to complete. When set: shop_hours = estimated_hours / required_people.

man_hoursnumber nullable

Computed: shop_hours × required_people. Legacy field.

shopHoursnumber nullable

Floor time per person. Computed from estimated_hours / required_people when estimate is set.

requiredPeopleinteger nullable

Simultaneous workers needed. Default 1. More people = shorter duration.

durationDaysinteger nullable

Wall-clock duration in whole working days (integer). The scheduling engine's canonical effort input.

countinteger nullable

Quantity/number of items for this operation. Only applicable when is_group = false.

start_datestring nullable

Start date for this operation/task in YYYY-MM-DD format. Set to empty string to clear.

operation_type_idinteger nullable

FK to operation_types. Set to null to clear operation type.

operation_equipment_type_idinteger nullable

FK to equipment_types for this task's operation. Set to null to clear.

additional_capability_idsinteger[] nullable

Replace extra capability IDs; send [] to clear. Omit to leave unchanged.

capabilitySourcestring nullable

Normally omitted: sending additional_capability_ids without it is recorded as a manual pick, which is what stops a later rename overwriting it.

integrationDocumentsobject[] nullable

Replace integration files: uploads, linked build docs (drawings bucket), and/or PM links; optional storage_source and build_doc_id on file rows; send [] to clear.

integrationLinksobject[] nullable

Replace integration links; send [] to clear.

integrationInstructionsHtmlstring nullable

Rich HTML integration instructions; send empty string to clear.

trackingModestring nullable

Progress tracking mode: 'none', 'checklist', or 'count'.

checklistSequentialboolean nullable

When true, checklist items must be completed in sequence order. Inspection items can only be completed by PM/manager.

reviewEvidenceRequiredboolean nullable

When true, PM approval of this task at review requires linked evidence.

completedCountinteger nullable

Number of completed units (count mode progress).

Response

Successful Response

unknown required

Changes

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