Skip to main content
POST
Create tag
Scope requis : TAGS_WRITE

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.

Autorisations

Authorization
string
header
requis

Corps

application/json
name
string
requis

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

Maximum string length: 255
Exemple:

"Interested"

color
string | null

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

Maximum string length: 7
Exemple:

"#123456"

Réponse

Tag created

data
object