Skip to main content

Tasks

GET WorkspaceProjectTasks​

https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks

Get project tasks for given workspace.

curl  https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters​

Path​

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace
project_idintegertrueNumeric ID of the project

Response​

200​

nametypedescription
activebooleanFalse when the task has been done
atstringWhen the task was created/last modified
estimated_secondsinteger | nullEstimation time for this task in seconds
idintegerTask ID
namestringTask Name
permissionsstring-
project_idintegerProject ID
recurringbooleanWhether this is a recurring task
server_deleted_atstring | nullWhen the task was deleted
toggl_accounts_idstring | nullTask assignee, if set above this will be the toggl_account_id for that user
tracked_secondsintegerThe value tracked_seconds is in milliseconds, not in seconds.
user_idinteger | nullTask assignee, if available
workspace_idintegerWorkspace ID

403​

User does not have access to this resource.

500​

Internal Server Error

POST WorkspaceProjectTasks​

https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks

Post project tasks for given workspace.

curl -X POST https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks \
-H "Content-Type: application/json" \
-d '{"active":"boolean","estimated_seconds":"integer","name":"string","project_id":"integer","user_id":"integer","workspace_id":"integer"}' \
-u <email>:<password>

Parameters​

Path​

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace
project_idintegertrueNumeric ID of the project

Body​

nametypedescription
activebooleanUse false to mark the task as done
estimated_secondsintegerTask estimation in seconds
namestringName
project_idintegerProject ID
user_idintegerCreator ID, if omitted will use requester user ID
workspace_idintegerWorkspace ID

Response​

200​

nametypedescription
activebooleanFalse when the task has been done
atstringWhen the task was created/last modified
estimated_secondsinteger | nullEstimation time for this task in seconds
idintegerTask ID
namestringTask Name
permissionsstring-
project_idintegerProject ID
recurringbooleanWhether this is a recurring task
server_deleted_atstring | nullWhen the task was deleted
toggl_accounts_idstring | nullTask assignee, if set above this will be the toggl_account_id for that user
tracked_secondsintegerThe value tracked_seconds is in milliseconds, not in seconds.
user_idinteger | nullTask assignee, if available
workspace_idintegerWorkspace ID

400​

Project not found/accessible, Can not change tasks of archived project

403​

User does not have access to this resource.

500​

Internal Server Error

PATCH WorkspaceProjectTasks​

https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_ids}

Patch project tasks for given workspace.

curl -X PATCH https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_ids} \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters​

Path​

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace
project_idintegertrueNumeric ID of the project
task_idsstringtrueNumeric IDs of project tasks separated by comma

Response​

200​

nametypedescription
failureArray of
nametypedescription
idinteger-
messagestring-
-
successArray of integer-

403​

User does not have access to this resource.

500​

Internal Server Error

GET WorkspaceProjectTask​

https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_id}

Get project task for given task id.

curl  https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_id} \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters​

Path​

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace
project_idintegertrueNumeric ID of the project
task_idintegertrueNumeric ID of the task

Response​

200​

nametypedescription
activebooleanFalse when the task has been done
atstringWhen the task was created/last modified
estimated_secondsinteger | nullEstimation time for this task in seconds
idintegerTask ID
namestringTask Name
permissionsstring-
project_idintegerProject ID
recurringbooleanWhether this is a recurring task
server_deleted_atstring | nullWhen the task was deleted
toggl_accounts_idstring | nullTask assignee, if set above this will be the toggl_account_id for that user
tracked_secondsintegerThe value tracked_seconds is in milliseconds, not in seconds.
user_idinteger | nullTask assignee, if available
workspace_idintegerWorkspace ID

403​

User does not have access to this resource.

500​

Internal Server Error

PUT WorkspaceProjectTask​

https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_id}

Put project task for given workspace.

curl -X PUT https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_id} \
-H "Content-Type: application/json" \
-d '{"active":"boolean","estimated_seconds":"integer","name":"string","project_id":"integer","user_id":"integer","workspace_id":"integer"}' \
-u <email>:<password>

Parameters​

Path​

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace
project_idintegertrueNumeric ID of the project
task_idstringtrueNumeric ID of project task

Body​

nametypedescription
activebooleanUse false to mark the task as done
estimated_secondsintegerTask estimation in seconds
namestringName
project_idintegerProject ID
user_idintegerCreator ID, if omitted will use requester user ID
workspace_idintegerWorkspace ID

Response​

200​

nametypedescription
activebooleanFalse when the task has been done
atstringWhen the task was created/last modified
estimated_secondsinteger | nullEstimation time for this task in seconds
idintegerTask ID
namestringTask Name
permissionsstring-
project_idintegerProject ID
recurringbooleanWhether this is a recurring task
server_deleted_atstring | nullWhen the task was deleted
toggl_accounts_idstring | nullTask assignee, if set above this will be the toggl_account_id for that user
tracked_secondsintegerThe value tracked_seconds is in milliseconds, not in seconds.
user_idinteger | nullTask assignee, if available
workspace_idintegerWorkspace ID

403​

User does not have access to this resource.

500​

Internal Server Error

DELETE WorkspaceProjectTask​

https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_id}

Delete projects task for given workspace.

curl -X DELETE https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_id} \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters​

Path​

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace
project_idintegertrueNumeric ID of the project
task_idintegertrueNumeric ID of the task

Response​

200​

Successful operation.

403​

User does not have access to this resource.

500​

Internal Server Error

GET Tasks​

https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/tasks

List Workspace tasks.

curl  https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/tasks \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters​

Path​

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace

Query​

nametyperequireddescription
sinceintegerfalseRetrieve tasks created/modified/deleted since this date using UNIX timestamp.
pageintegerfalsePage number, default 1
per_pageintegerfalseNumber of items per page, default 50
sort_orderstringfalseSort order, default ASC
sort_fieldstringfalseField used for sorting
activebooleanfalseFilter by active state
pidintegerfalseFilter by project id
start_datestringfalseSmallest boundary date in the format YYYY-MM-DD
end_datestringfalseBiggest boundary date in the format YYYY-MM-DD

Response​

200​

nametypedescription
dataArray of
nametypedescription
activebooleanFalse when the task has been done
atstringWhen the task was created/last modified
estimated_secondsinteger | nullEstimation time for this task in seconds
idintegerTask ID
namestringTask Name
permissionsstring-
project_idintegerProject ID
recurringbooleanWhether this is a recurring task
server_deleted_atstring | nullWhen the task was deleted
toggl_accounts_idstring | nullTask assignee, if set above this will be the toggl_account_id for that user
tracked_secondsintegerThe value tracked_seconds is in milliseconds, not in seconds.
user_idinteger | nullTask assignee, if available
workspace_idintegerWorkspace ID
-
pageinteger-
per_pageinteger-
sort_fieldstring-
sort_orderstring-
total_countinteger-

403​

User does not have access to this resource.

500​

Internal Server Error
© 2024 Toggl. All rights reserved.