Tags

Tags are labels you can attach to wins for filtering and organization.

List tags

GET /api/v1/tags

Returns a paginated list of tags with win counts, ordered alphabetically.

Only tags attached to wins that you can currently access are listed. Counts include only those wins. Unused tags are not listed.

Query parameters

Parameter	Type	Description
page	integer	Page number (default: 1)
per_page	integer	Items per page (default: 25, max: 100)

Example

Request

curl https://app.myhypedoc.com/api/v1/tags \
  -H "Authorization: Bearer $HYPEDOC_TOKEN"

Response

[
  {
    "id": 1,
    "name": "impact",
    "wins_count": 15,
    "created_at": "2026-01-05T08:00:00Z"
  },
  {
    "id": 2,
    "name": "launch",
    "wins_count": 8,
    "created_at": "2026-01-10T14:00:00Z"
  }
]

Note

Tags are created automatically when you add them to a win. There is no POST /api/v1/tags endpoint. Include tag_names when creating or updating a win.

---

Rename a tag

PATCH /api/v1/tags/:id

Renames a tag. The new name applies to all wins that use this tag.

You must own the tag and have permission to edit every win that uses it.

Body parameters

Parameter	Type	Required	Description
tag[name]	string	Yes	New name for the tag (max 30 characters)

Example

Request

curl -X PATCH https://app.myhypedoc.com/api/v1/tags/1 \
  -H "Authorization: Bearer $HYPEDOC_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tag": {"name": "high-impact"}}'

Response

{
  "id": 1,
  "name": "high-impact",
  "wins_count": 15,
  "created_at": "2026-01-05T08:00:00Z"
}

Error codes

Status	Description
403	You cannot edit one or more wins that use this tag
404	Tag not found
422	Validation error (e.g. name already taken, blank, or too long)

---

Delete a tag

DELETE /api/v1/tags/:id

Deletes a tag. Wins that had this tag are kept; only the tag association is removed.

You must own the tag and have permission to edit every win that uses it.

Example

curl -X DELETE https://app.myhypedoc.com/api/v1/tags/3 \
  -H "Authorization: Bearer $HYPEDOC_TOKEN"

Returns 204 No Content on success.

Error codes

Status	Description
403	You cannot edit one or more wins that use this tag
404	Tag not found