Passer au contenu principal
PATCH
Mettre à jour un Tag
Met à jour les champs fournis d’un Tag. Les champs omis gardent leur valeur actuelle. Branded et Non-branded sont des noms de Tags système réservés, quelle que soit la casse. Vous ne pouvez pas mettre à jour l’un de ces deux Tags système ni renommer un autre Tag avec l’un de ces noms. Nécessite une offre Business, Agency Business ou Enterprise active. Utilisez un jeton d’API dont l’accès en écriture est activé. Consultez Écrire des données pour l’idempotence, les requêtes conditionnelles et la gestion des erreurs.
string
requis
Jeton bearer de votre équipe.
string
requis
Copiez l’ETag complet du dernier GET, guillemets compris.
string
requis
Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.
string
requis
Identifiant du Tag dans ce workspace.
string
Nom du Tag, 1 à 120 caractères après suppression des espaces en bordure.
string | null
Couleur hexadécimale à six chiffres, comme #7B3AEE. Définissez null pour l’effacer.
Fournissez au moins name ou color.

Réponse

Renvoie 200 avec un objet tag de la même forme que Obtenir un Tag et un nouvel ETag. La réponse de mutation n’a pas de champ success au premier niveau. Traitez les versions comme des valeurs opaques, et non comme des compteurs.

Requête et réponse synthétiques

Lisez d’abord le Tag actuel. Cet exemple suppose que son ETag est "4".

Erreurs

Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur 429, respectez Retry-After ; les écritures peuvent renvoyer 503 SERVICE_UNAVAILABLE si le limiteur d’écriture est indisponible.