Language

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}'
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>"
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}'
Language