Appearance
Short Link Tags
Introduction
The Short Link Tags API provides a way to associate tags with your shortened URLs. Tags allow you to organize and categorize your short links, making it easier to manage and search for them based on specific attributes.
With these endpoints, you can:
- List all tags associated with a specific short link.
- Add new tags to a short link.
- Remove tags from a short link.
List Short Link Tags
Description: Lists all tags associated with a specific short link.
- Method:
GET
- Endpoint:
/tools/short-links/{id}/tags
- Path Parameters:
id
(integer, required): The ID of the short link.
Example Request
http
GET /tools/short-links/abc123/tags
Content-Type: application/json
Accept: application/json
Authorization: Bearer {API_TOKEN}
Example Response
http
HTTP Status Code: 200
Content-Type: application/json
json
{
"data": [
"Tag 1",
"Tag 2",
...
]
}
Add Short Link Tag
Description: Adds a new tag to a specific short link.
- Method:
POST
- Endpoint:
/tools/short-links/{id}/tags
- Path Parameters:
id
(integer, required): The ID of the short link.
- Body Parameters:
name
(string, required): The name of the tag to add.
Example Request
http
POST /tools/short-links/abc123/tags
Content-Type: application/json
Accept: application/json
Authorization: Bearer {API_TOKEN}
json
{
"name": "Tag 3"
}
Example Response
http
HTTP Status Code: 200
Content-Type: application/json
json
{
"data": [
"Tag 1",
"Tag 2",
"Tag 3",
...
]
}
Delete Short Link Tag
Description: Delete a specific tag from a short link by tag name.
- Method:
DELETE
- Endpoint:
/tools/short-links/{id}/tags
- Path Parameters:
id
(integer, required): The ID of the short link to delete.
- Body Parameters:
name
(string, required): The name of the tag to add.
Example Request
http
DELETE /tools/short-links/abc123/tags
Content-Type: application/json
Accept: application/json
Authorization: Bearer {API_TOKEN}
json
{
"name": "Tag 1"
}
Example Response
http
HTTP Status Code: 200
Content-Type: application/json
json
{
"data": [
"Tag 2",
"Tag 3",
...
]
}