Skip to content
DocumentationHelpFROpen my Rynqu

API reference → Tags

GET/api/tags

List tags

Returns every tag created by the AI or manually in your account, sorted alphabetically. Use them to filter or categorize your links in your own integrations.

AI-generated tags: Rynqu automatically extracts relevant tags for each link after processing. They appear here with a color randomly assigned on first use.

Example request

curl "https://rynqu.com/api/tags" \
  -H "Authorization: Bearer sk_xxxx"

Response — 200 OK

[
  {
    "id": "t1-uuid-0000-0000-000000000001",
    "name": "javascript",
    "color": "#6366f1",
    "createdAt": "2026-05-01T08:00:00.000Z"
  },
  {
    "id": "t2-uuid-0000-0000-000000000002",
    "name": "design",
    "color": "#ec4899",
    "createdAt": "2026-05-02T09:30:00.000Z"
  },
  {
    "id": "t3-uuid-0000-0000-000000000003",
    "name": "machine-learning",
    "color": "#f59e0b",
    "createdAt": "2026-05-03T11:15:00.000Z"
  }
]

Fields

FieldTypeDescription
idstring (uuid)Unique ID of the tag.
namestringLowercase tag name, no spaces (e.g. machine-learning).
colorstring (hex)Display color of the tag in the dashboard.
createdAtISO 8601Date the tag was first used.

Possible errors

401UNAUTHORIZEDAPI key missing or invalid.
429RATE_LIMIT_EXCEEDEDRequest quota exceeded.
Delete a linkSecurity & Privacy →