Skip to main content

Tags

GET Tags

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

List Workspace tags.

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

Parameters

Path

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace

Response

200

Array of:

nametypedescription
atstringWhen was created/last modified
deleted_atstringWhen was deleted
idintegerTag ID
namestringTag name
workspace_idintegerWorkspace ID

403

User does not have access to this resource.

500

Internal Server Error

POST Create tag

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

Create workspace tags.

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

Parameters

Path

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace

Body

nametypedescription
namestringTag name
workspace_idintegerWorkspace ID

Response

200

Array of:

nametypedescription
atstringWhen was created/last modified
deleted_atstringWhen was deleted
idintegerTag ID
namestringTag name
workspace_idintegerWorkspace ID

400

Possible errors:

* Invalid JSON input
* tag name can't be blank
* a tag with the name '{tag_name}' already exists

403

Only organization or workspace administrators may manage tags in this workspace.

500

Internal Server Error

PUT Update tag

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

Update workspace tags.

curl -X PUT https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/tags/{tag_id} \
-H "Content-Type: application/json" \
-d '{"name":"string","workspace_id":"integer"}' \
-u <email>:<password>

Parameters

Path

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace
tag_idintegertrueNumeric ID of the tag

Body

nametypedescription
namestringTag name
workspace_idintegerWorkspace ID

Response

200

Array of:

nametypedescription
atstringWhen was created/last modified
deleted_atstringWhen was deleted
idintegerTag ID
namestringTag name
workspace_idintegerWorkspace ID

400

Possible errors:

* Invalid JSON input
* Invalid tag ID
* tag name can't be blank
* a tag with the name '{tag_name}' already exists

403

Only organization or workspace administrators may manage tags in this workspace.

404

Tag was not found

500

Internal Server Error

DELETE Delete tag

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

Delete workspace tags.

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

Parameters

Path

nametyperequireddescription
workspace_idintegertrueNumeric ID of the workspace
tag_idintegertrueNumeric ID of the tag

Response

200

Successful operation.

400

Invalid tag ID.

403

Only organization or workspace administrators may manage tags in this workspace.

404

Tag was not found.

500

Internal Server Error
© 2023 Toggl. All rights reserved.