Tags API

Label short links with free-form tags for filtering and search

Tags are free-form string labels you can attach to any short link. A link can have multiple tags. You can then filter your link list by tag in the dashboard or via the Saved Views API. Tags are available on all plans.

Base URL

https://awsys.co

Authentication

All tag endpoints require a valid API key passed as a Bearer token. See the Authentication page for details.

Authorization: Bearer YOUR_API_KEY

Add Tags to a Link

POST /api/link/:short/tags

Adds one or more tags to a link. Tags are merged with any existing tags — duplicates are ignored.

Path parameters

Request body

{
  "tags": ["campaign-q3", "email", "social"]
}

Response — 200 OK

{
  "success": true,
  "tags": ["campaign-q3", "email", "social"]
}

curl example

curl -X POST https://awsys.co/api/link/abc123/tags \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["campaign-q3", "email"]}'

Remove a Tag from a Link

DELETE /api/link/:short/tags/:tag

Removes a single tag from a link. URL-encode the tag name if it contains special characters.

Path parameters

Response — 200 OK

{
  "success": true,
  "tags": ["email", "social"]
}

curl example

curl -X DELETE https://awsys.co/api/link/abc123/tags/campaign-q3 \
  -H "Authorization: Bearer YOUR_API_KEY"

Tags in Link Objects

When you retrieve a link via GET /api/link/:short or GET /api/user/links, the response includes a tags array. An empty array means no tags are set.

{
  "short": "abc123",
  "long": "https://example.com/landing-page",
  "tags": ["campaign-q3", "email"],
  "opened": 47
}

Error Codes