Skip to main content

​
Endpoint

GET /api/user/tags/:id
Retrieves a specific tag by its ID. You can only access tags that belong to your account.

​
Authentication

Requires authentication via API token or session cookie.

​
Path parameters

​
id
string
required
The tag ID

​
Response

Returns the tag object.
​
id
string
Unique identifier for the tag
​
name
string
Tag name
​
color
string
Hex color code for the tag
​
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/cld1234567890

​
Response

{
  "id": "cld1234567890",
  "name": "Screenshots",
  "color": "#3b82f6",
  "userId": "user123",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

​
Errors

​
404
error
Not found - Tag does not exist or doesn’t belong to your account
​
401
error
Unauthorized - Invalid or missing authentication token

Build docs developers (and LLMs) love

Get started for freeTalk to us