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.

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 YOUR_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.

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 YOUR_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
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.

Example

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

Returns 204 No Content on success.

Error codes

Status	Description
404	Tag not found