v1Ressources/Approvals/postMettre à jour les champs des tâches
Mettre à jour les champs des tâches
Crée, renomme ou archive un champ personnalisé des Tâches, ou définit des valeurs sur les tâches que le créateur de la clé peut voir. Envoyez un mutationId et une command. Les champs sont partagés dans tout l'espace de travail. Les erreurs utilisent le format d'erreur de Tâches et validations.
post
approvals:write/api/v1/work-management/tasks/fieldsCorps de la requête
mutationIdstringobligatoire
Un UUID que vous choisissez pour cette modification. Le renvoyer avec la même command renvoie le premier résultat sans réappliquer la modification ; le réutiliser avec une autre command renvoie 409.
commandobjectobligatoire
Une modification. field_create ajoute un champ avec label, type et options. field_update renomme un champ, modifie ses options, ou l'archive ou le restaure, et exige la version actuelle du champ comme expectedVersion. values_update définit de 1 à 1000 valeurs, chacune avec recordId, fieldId, value et expectedVersion, et les applique toutes ou aucune. Une option encore utilisée par des enregistrements ne peut pas être supprimée ; archivez-la plutôt. Un jeu de champs contient au maximum 40 champs, champs archivés compris.
Erreurs
400La requête est invalide, par exemple une command mal formée, un corps de plus de 1 Mo ou une valeur qui ne correspond pas au champ.
401Clé API manquante, invalide, expirée ou révoquée.
403Le créateur de la clé n'est pas autorisé à utiliser les champs des tâches.
404La tâche ou le champ n'est pas disponible pour le créateur de la clé.
409Un champ ou l'une de ses valeurs stockées a changé depuis votre lecture, un champ portant ce nom existe déjà, ou le mutationId a déjà été utilisé avec une autre command.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
500La requête n'a pas pu aboutir à cause d'un problème de notre côté.
503Le service est temporairement indisponible. Réessayez plus tard.
post/api/v1/work-management/tasks/fields
Votre clé API
Corps de la requête*
{}