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)