UPDATE Master Tasks

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Update Master Task

Update an existing master task with new information such as name, description, favorite status, position assignments, and color.

Permissions

Minimum Role Required: Supervisor

Users with Supervisor and above roles can update master tasks that belong to their company.

API Endpoint

Method: PATCH

URL: {baseUrl}/api/v2/master-tasks/{taskId}?access_token={token}

Parameters

Parameter	Type	Required	Description
`name`	string	optional	The name of the master task
`description`	string	optional	Description of the master task
`favorite`	boolean	optional	Whether the task is marked as favorite
`positionIds`	array of int	optional	Array of position IDs associated with the task
`color`	string	optional	Color code for the task (hex format)

Request Example

{
    "name": "Write API documentation -> edited"
}

Response Example

{
    "status": 1,
    "data": {
        "id": "01k6d0xksd04t0ztrhbzqettb0",
        "companyId": 11,
        "name": "Write API documentation -> edited",
        "description": "",
        "favorite": false,
        "color": "#B0BFC5",
        "positionIds": [
            62580
        ],
        "createdBy": 39737,
        "createdAt": "2025-09-30T09:58:05+00:00",
        "updatedBy": 2,
        "updatedAt": "2025-09-30T14:19:32+00:00",
        "deletedBy": null,
        "deletedAt": null
    },
    "metadata": [],
    "token": "token",
    "error": null
}

Response Fields

Field	Type	Description
`status`	integer	Response status (1 for success)
`data`	object	Updated master task data
`data.id`	string	Unique identifier for the master task
`data.companyId`	integer	ID of the company the task belongs to
`data.name`	string	Name of the master task
`data.description`	string	Task description
`data.favorite`	boolean	Favorite status
`data.color`	string	Task color in hex format
`data.positionIds`	array	Array of associated position IDs
`data.createdBy`	integer	ID of user who created the task
`data.createdAt`	string	Creation timestamp
`data.updatedBy`	integer	ID of user who last updated the task
`data.updatedAt`	string	Last update timestamp
`data.deletedBy`	integer	ID of user who deleted the task (null if not deleted)
`data.deletedAt`	string	Deletion timestamp (null if not deleted)
`metadata`	array	Additional metadata
`token`	string	Access token
`error`	string	Error message (null on success)