POST /v1/actions/list-tags

Renvoie chaque tag de votre tenant avec son nombre actuel de contacts. Filtre optionnel par sous-chaîne sur le nom du tag.

POST /api/v1/actions/list-tags

Corps de la requête

Champ	Type	Requis	Notes
name	string	non	Correspondance par sous-chaîne (insensible à la casse)

curl -X POST https://www.qyvo.io/api/v1/actions/list-tags \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{}'

const tags = await fetch('https://www.qyvo.io/api/v1/actions/list-tags', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.QYVO_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: '{}',
}).then((r) => r.json());

$tags = Http::withToken(env('QYVO_TOKEN'))
    ->post('https://www.qyvo.io/api/v1/actions/list-tags', [])
    ->json();

import os, httpx
tags = httpx.post(
    'https://www.qyvo.io/api/v1/actions/list-tags',
    headers={'Authorization': f"Bearer {os.environ['QYVO_TOKEN']}"},
    json={},
).json()

Réponse — 200 OK

[
  {
    "id": "01J2T...",
    "name": "vip",
    "contacts_count": 217,
    "created_at": "2026-04-15T10:32:00+00:00"
  },
  {
    "id": "01J2U...",
    "name": "fr-FR",
    "contacts_count": 1842,
    "created_at": "2026-04-16T11:00:00+00:00"
  }
]

Les tags sont scopés au tenant et passés en minuscules à la création. Le contacts_count est calculé en direct (pas de cache), il reflète donc l'état actuel.