For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeveloper ForumLogin
  • Overview
    • Introduction
    • Getting Started
    • Integration Example (PSA)
    • Authentication
    • Error Handling
    • Pagination
    • Filtering
    • Ordering
    • Rate Limits
    • Permissions
    • Webhooks
    • MCP Server
    • Versioning
    • Changelog
    • Support
  • API v1 Reference
    • Projects Overview
    • Tasks Overview
      • POSTRemoves a tag from all private tasks.
      • GETReturns all tags of the private tasks of the current user.
      • POSTUpdates a tag for all private tasks.
      • POSTRemoves a tag from all project tasks.
      • GETReturns all task tags that are currently in use by tasks.
      • POSTUpdates a tag globally for all project tasks.
      • POSTAdds a batch of tags to the task with the specified id.
      • POSTRemoves tags from the task with the specified id.
      • GETReturns the tags of the task with the specified id.
    • Time Tracking Overview
    • Documents Overview
    • Search Overview
    • Companies Overview
    • Users Overview
    • Files & Images Overview
    • Custom Fields Overview
    • Workload & Planning Overview
    • Project Templates Overview
    • Workflows Overview
    • Login & Access Overview
    • API Management Overview
LogoLogo
SupportDeveloper ForumLogin
API v1 ReferenceTask Tags

Returns all tags of the private tasks of the current user.

GET
https://api.awork.com/api/v1/me/privatetasks/tags
GET
/api/v1/me/privatetasks/tags
$curl https://api.awork.com/api/v1/me/privatetasks/tags \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json"
200Retrieved
1[
2 {
3 "name": "Urgent",
4 "color": "red",
5 "usageCount": 12
6 },
7 {
8 "name": "Client",
9 "color": "blue",
10 "usageCount": 8
11 },
12 {
13 "name": "Research",
14 "color": "green",
15 "usageCount": 5
16 }
17]
<Check title="Required Permissions" icon="key">Any authenticated user.</Check>
Was this page helpful?
Previous

Updates a tag for all private tasks.

Next
Built with
Required Permissions
Any authenticated user.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

OK
namestring or null
The name of the tag.
colorstring or null
The color of the tag.
usageCountinteger
The count how often a specific tag was already used.