Synup
Créer une clé
v1Ressources/Approvals/putDéfinir le responsable d'une tâche

Définir le responsable d'une tâche

Fait d'une personne le responsable d'une tâche, en remplaçant le responsable précédent. Chaque responsable retiré reste dans l'historique de la tâche, et l'ancien comme le nouveau responsable reçoivent une notification. Utilisez GET /api/v1/work-management/owners pour savoir qui est éligible. Un utilisateur client ne peut être responsable que si la tâche a un client, et seulement s'il appartient à ce client. Changer de responsable pendant que la tâche attend une validation renvoie 409 : retirez d'abord la demande de validation. Une tâche hors de l'accès client de la clé renvoie 403. Les nouvelles tentatives avec le même idempotencyKey et le même corps renvoient le premier résultat avec replayed à true. Si Tâches et validations n'est pas activé pour votre espace de travail, la réponse est 404.

put/api/v1/work-management/tasks/{id}/owner
approvals:write
Paramè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*
{}

Vous débutez avec l'API Synup ?