Allo

Creer un tag

Transmettez un nom d'affichage — la cle du tag (son identifiant dans le reste de l'API) est generee automatiquement en slugifiant le nom (minuscules…

POST/v2/api/tags

Comportement

Transmettez un nom d'affichage — la cle du tag (son identifiant dans le reste de l'API) est generee automatiquement en slugifiant le nom (minuscules, alphanumerique). Par exemple "Interested" devient la cle interested.

  • Les noms sont insensibles a la casse. Creer Support alors que support existe deja retourne une erreur 409 avec le code TAG_ALREADY_EXISTS.
  • Les noms qui decrivent un resultat d'appel (ex. voicemail, missed call, busy) sont reserves et rejetes avec une erreur 400 et le code TAG_NAME_IS_CALL_OUTCOME.
  • color est une chaine hexadecimale optionnelle (7 caracteres maximum, ex. #FF0000).

L'id du tag cree est la cle generee — utilisez-la pour ajouter le tag a des appels ou pour le supprimer.

Idempotence

Cet endpoint prend en charge l'en-tete Idempotency-Key. Si une requete reussit et que vous la renvoyez avec la meme cle, la reponse stockee est retournee sans re-executer l'operation. Voir Idempotence.

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Corps

namestringrequis

Tag display name. The key (identifier) is derived from it.

colorstring | null

Optional hex color (e.g. #FF0000).

Réponses

201Tag created
dataobject
3 champs
idstring
namestring
colorstring
400
401
409
429