Skip to main content

​
Endpoint

GET /api/user/tags
Returns all tags created by the authenticated user. Tags are used to organize and categorize files.

​
Authentication

Requires authentication via API token or session cookie.

​
Response

Returns an array of tag objects.
​
id
string
Unique identifier for the tag
​
name
string
Tag name
​
color
string
Hex color code for the tag (e.g., #3b82f6)
​
userId
string
ID of the user who owns this tag
​
createdAt
string
ISO 8601 timestamp of when the tag was created
​
updatedAt
string
ISO 8601 timestamp of when the tag was last updated

​
Example

curl -H "Authorization: YOUR_API_TOKEN" \
  https://your-zipline.com/api/user/tags

​
Response

[
  {
    "id": "cld1234567890",
    "name": "Screenshots",
    "color": "#3b82f6",
    "userId": "user123",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": "cld0987654321",
    "name": "Work",
    "color": "#10b981",
    "userId": "user123",
    "createdAt": "2024-01-10T14:20:00.000Z",
    "updatedAt": "2024-01-10T14:20:00.000Z"
  }
]

​
Use cases

  • Display all available tags in a file management UI
  • Build tag selection dropdowns
  • Sync tags across multiple clients