v1Ressources/Approvals/postCreate an approvals tag
Create an approvals tag
Approvals tags organize items in Inbox → Approvals and are separate from Social Inbox tags. Tag names and colors are shared across the workspace; usage counts are not returned. Tags are added or removed only on items the token creator can currently see, and an item it can’t see is skipped, never tagged. Tagging is not a decision and grants no access.
post
approvals:write/api/v1/work-management/approval-tagsCorps de la requête
namestringobligatoire
The tag's name, 1 to 60 characters. Creating a tag with the name of an archived approvals tag brings that tag back.
colorstring (neutral | accent | success | warning | danger)facultatif
The tag's color: neutral, accent, success, warning or danger. Optional.
Réponse
okbooleanfacultatif
Toujours true pour une réponse réussie.
tagobjectfacultatif
idstringfacultatif
The tag's id. Pass it in add or remove when tagging items.
namestringfacultatif
The tag's name, 1 to 60 characters. Creating a tag with the name of an archived approvals tag brings that tag back.
colorstringfacultatif
The tag's color: neutral, accent, success, warning or danger. Optional.
Erreurs
400Les erreurs de Tâches et validations renvoient ok: false avec un objet error contenant code, message, retryable et details. Les erreurs de la vérification de la clé API elle-même (clé absente ou invalide, scope manquant, limite de débit) utilisent le format standard, où error est une chaîne.
401Clé API manquante, invalide, expirée ou révoquée.
403Les erreurs de Tâches et validations renvoient ok: false avec un objet error contenant code, message, retryable et details. Les erreurs de la vérification de la clé API elle-même (clé absente ou invalide, scope manquant, limite de débit) utilisent le format standard, où error est une chaîne.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/work-management/approval-tags
Votre clé API
Corps de la requête*
{}