Tags
Generated from LinkSnap's own code: every route in this area, what it takes and how to call it.
| Method | Path | What it does |
|---|---|---|
GET |
/api/v1/tags |
List tags |
POST |
/api/v1/tags |
Create tag |
DELETE |
/api/v1/tags/{id} |
Detaches it from every link and QR code. |
PATCH |
/api/v1/tags/{id} |
Rename tag — the tag keeps its id, so every link and QR code that carries it follows the rename for free (implicit m2m join rows key on the id, not the name). |
List tags
GET /api/v1/tags
Example
curl -X GET "https://linksnap.forjio.com/api/v1/tags" \
-H "Authorization: ApiKey lsk_live_<your API key>"
Create tag
POST /api/v1/tags
Body
| Field | Type | Required | Notes |
|---|---|---|---|
name |
any | no |
Example
curl -X POST "https://linksnap.forjio.com/api/v1/tags" \
-H "Authorization: ApiKey lsk_live_<your API key>" \
-H "Content-Type: application/json" \
-d '{"name":null}'
Detaches it from every link and QR code.
DELETE /api/v1/tags/{id}
Delete tag — detaches it from every link and QR code. The implicit many-to-many join tables (_LinkToTag / _QrCodeToTag) cascade on tag delete (see the init migration), so the links and QR codes themselves are untouched; they just lose the label.
Path parameters
| Name | Type | Required | Notes |
|---|---|---|---|
id |
string | yes |
Example
curl -X DELETE "https://linksnap.forjio.com/api/v1/tags/:id" \
-H "Authorization: ApiKey lsk_live_<your API key>"
Rename tag — the tag keeps its id, so every link and QR code that carries it follows the rename for free (implicit m2m join rows key on the id, not the name).
PATCH /api/v1/tags/{id}
Rename tag — the tag keeps its id, so every link and QR code that carries it follows the rename for free (implicit m2m join rows key on the id, not the name).
Path parameters
| Name | Type | Required | Notes |
|---|---|---|---|
id |
string | yes |
Body
| Field | Type | Required | Notes |
|---|---|---|---|
name |
any | no |
Example
curl -X PATCH "https://linksnap.forjio.com/api/v1/tags/:id" \
-H "Authorization: ApiKey lsk_live_<your API key>" \
-H "Content-Type: application/json" \
-d '{"name":null}'