Task

Update a task on a project

Changed on Aug 20, 2026

put/v1/workspaces/{workspaceId}/projects/{projectId}/tasks/{taskId}

Request

Base URL: https://api.clockify.me/api
URL: https://api.clockify.me/api/v1/workspaces/{workspaceId}/projects/{projectId}/tasks/{taskId}
Auth: one of:
- API key in header x-api-key
- API key in header x-addon-token

Path parameters

taskIdstring required

Represents a task identifier across the system.

Example:57a687e29ae1f428e7ebe107

workspaceIdstring required

Represents a workspace identifier across the system.

Example:64a687e29ae1f428e7ebe303

projectIdstring required

Represents a project identifier across the system.

Example:25b687e29ae1f428e7ebe123

Query parameters

contains-assigneeboolean

Flag to set whether task will have assignee or none.

membership-status'PENDING' | 'ACTIVE' | 'DECLINED' | 'INACTIVE' | 'ALL'

Represents a membership status.

Request body

assigneeIdstring

assigneeIdsstring[]

Represents list of assignee ids for the task.

billableboolean

Indicates whether a task is billable or not.

budgetEstimateinteger

Represents a task budget estimate as integer.

estimatestring

Represents a task duration estimate.

namestring required

Represents task name.

status'ACTIVE' | 'DONE' | 'ALL'

Represents task status.

userGroupIdsstring[]

Represents list of user group ids for the task.

Example request

{
  "assigneeIds": [
    "45b687e29ae1f428e7ebe123",
    "67s687e29ae1f428e7ebe678"
  ],
  "budgetEstimate": 10000,
  "estimate": "PT1H30M",
  "name": "Bugfixing",
  "status": "DONE",
  "userGroupIds": [
    "67b687e29ae1f428e7ebe123",
    "12s687e29ae1f428e7ebe678"
  ]
}

Response

TaskDtoV1 required(unresolved $ref)

Changes

Aug 20, 2026a5b636acbcd8 Revision changes
- info
  the request property default value was added
- info
  the request property default value was added
- info
  the request property default value was added
- info
  the request property default value was added
- info
  the request property default value was added
- info
  the request property default value was added
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status

Operation history