# `api.jobs.timeline.update_task` > `PATCH /job/{jobDisplayId}/timeline/{timelineTaskId}` — ACPortal **Python** ```python api.jobs.timeline.update_task(job_display_id: int, task_id: str, *, data: TimelineTaskUpdateRequest | dict) -> TimelineTask ``` **CLI** ```bash ab jobs timeline update_task [--data ...] ``` ``PATCH /job/{jobDisplayId}/timeline/{timelineTaskId}`` Request model: :class:`TimelineTaskUpdateRequest`. ## Request body — `TimelineTaskUpdateRequest` | Field | Type | Required | Description | |---|---|---|---| | `status` | `Optional[int]` | no | New status code | | `scheduledDate` | `Optional[str]` | no | Updated schedule | | `completedDate` | `Optional[str]` | no | Completion date | | `comments` | `Optional[str]` | no | Updated notes | ## Response Returns `TimelineTask`. | Field | Type | Required | Description | |---|---|---|---| | `createdDate` | `Optional[datetime]` | no | Creation timestamp | | `modifiedDate` | `Optional[datetime]` | no | Last modification timestamp | | `createdBy` | `Optional[str]` | no | Creator identifier | | `modifiedBy` | `Optional[str]` | no | Last modifier identifier | | `id` | `Optional[int]` | no | Timeline task integer ID | | `jobId` | `Optional[str]` | no | Job UUID | | `taskCode` | `Optional[str]` | no | Task code (PU/PK/ST/CP) | | `plannedStartDate` | `Optional[str]` | no | Planned start date | | `targetStartDate` | `Optional[str]` | no | Target start date | | `actualEndDate` | `Optional[str]` | no | Actual end date | | `notes` | `Optional[list[dict]]` | no | JobTaskNote objects | | `workTimeLogs` | `Optional[list[dict]]` | no | WorkTimeLog objects | | `initialNote` | `Optional[dict]` | no | InitialNoteModel | | `timeLog` | `Optional[dict]` | no | TimeLog (PK/ST tasks) | | `plannedEndDate` | `Optional[str]` | no | Planned end date | | `preferredStartDate` | `Optional[str]` | no | Preferred start date | | `preferredEndDate` | `Optional[str]` | no | Preferred end date | | `truck` | `Optional[dict]` | no | Truck assignment | | `onSiteTimeLog` | `Optional[dict]` | no | On-site time log (PU) | | `tripTimeLog` | `dict \| str \| None` | no | Trip time log (PU) | | `completedDate` | `Optional[str]` | no | Completed date (PU) | | `scheduledDate` | `Optional[str]` | no | Carrier scheduled date | | `pickupCompletedDate` | `Optional[str]` | no | Carrier pickup completed | | `deliveryCompletedDate` | `Optional[str]` | no | Carrier delivery completed | | `expectedDeliveryDate` | `Optional[str]` | no | Expected delivery date | --- [← Back to api.jobs](../jobs.md)