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.

Support Developer Forum Login

Overview
API v1 Reference

Support Developer Forum Login

API v1 Reference Project Tags

Returns all tags currently in use by projects.

GET

https://api.awork.com/api/v1/projects/tags

GET

/api/v1/projects/tags

$ curl https://api.awork.com/api/v1/projects/tags \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 [
2   {
3     "name": "UI/UX",
4     "color": "blue",
5     "usageCount": 42
6   },
7   {
8     "name": "Backend",
9     "color": "green",
10     "usageCount": 35
11   },
12   {
13     "name": "Marketing",
14     "color": "orange",
15     "usageCount": 18
16   },
17   {
18     "name": "Design",
19     "color": "purple",
20     "usageCount": 27
21   }
22 ]

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

Was this page helpful?

Updates a tag globally for all projects.

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.

Errors

400

Bad Request Error

401

Unauthorized Error