v1Ressources/Approvals/putDéfinir le responsable d'une tâche
Définir le responsable d'une tâche
Remplace le responsable de la tâche par un membre de l’agence ou un utilisateur client éligible. L’appelant et le nouveau responsable doivent déjà avoir accès selon les restrictions actuelles du client et du projet privé. Une attribution ne partage jamais l’accès. Un utilisateur client doit appartenir au client de la tâche ; il ne peut pas recevoir de tâche sans client. Les modifications sont refusées pendant une révision en attente.
put
approvals:write/api/v1/work-management/tasks/{id}/ownerParamètres de requête
idstringobligatoire
L'id de la tâche, un UUID. Toute autre valeur renvoie 404.
Corps de la requête
idempotencyKeystringobligatoire
Une chaîne unique de votre choix, de 8 à 200 caractères. Réutilisez-la uniquement pour relancer la même requête.
userIdstringobligatoire
L'id du nouveau responsable, issu de GET /api/v1/work-management/owners.
ownerTypestring (user | client_user)facultatif
Indique si le responsable est un membre de l'équipe de l'agence (user) ou un utilisateur client (client_user). Par défaut : user.
notestringfacultatif
Une note facultative pour le nouveau responsable, jusqu'à 500 caractères.
Réponse
okbooleanfacultatif
Toujours true pour une réponse réussie.
dataobjectfacultatif
keystringfacultatif
La clé de la tâche, au format task:<id>.
assignmentIdstringfacultatif
L'id de l'attribution du responsable.
replacedintegerfacultatif
Nombre de responsables précédents retirés. 0 si la personne était déjà responsable de la tâche.
replayedbooleanfacultatif
true lorsque cette réponse reprend une requête précédente avec le même idempotencyKey : rien de nouveau n'a été enregistré.
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.
404Les 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.
409Les 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.
500La requête n'a pas pu aboutir à cause d'un problème de notre côté.
put/api/v1/work-management/tasks/{id}/owner
Votre clé API
id *
Corps de la requête*
{}