Aller au contenu
AssilyaAssilya

Créer un tag (idempotent)

POST
/api/tags

Crée le tag s’il n’existe pas encore. Si un tag porte déjà ce nom, il est renvoyé tel quel — sa couleur d’origine est conservée.

Authorizations

Section intitulée « Authorizations »

Request Bodyrequired

Section intitulée « Request Bodyrequired »
object
name
required
string
<= 80 characters
color

L’une des 16 couleurs de la palette de tags.

string
Allowed values: red orange amber yellow lime green emerald teal cyan sky blue indigo violet fuchsia pink rose

Responses

Section intitulée « Responses »

200

Section intitulée « 200 »

Tag créé ou existant.

object
tag
object
id
string format: uuid
name
string
color
One of:

L’une des 16 couleurs de la palette de tags.

string
Allowed values: red orange amber yellow lime green emerald teal cyan sky blue indigo violet fuchsia pink rose

401

Section intitulée « 401 »

Clé API absente ou en-tête Authorization mal formé.

object
error

Message d’erreur lisible, dans la langue de l’agent.

string

422

Section intitulée « 422 »

Corps de requête invalide (erreurs de validation Laravel).

object
message
string
errors
object
key
additional properties
Array<string>

429

Section intitulée « 429 »

Limites de débit dépassées. Plafonds appliqués simultanément : 30/min par conversation, 200/min par agent, 120/min par IP et 1 000/min par espace (valeur par défaut).

object
error

Message d’erreur lisible, dans la langue de l’agent.

string