Synup
Créer une clé
v1Ressources/Approvals/getLister les responsables de tâches

Lister les responsables de tâches

Renvoie les personnes qui peuvent être responsables d'une tâche dans Tâches et validations : les membres de l'équipe de l'agence ayant accès à Tâches et validations, et les utilisateurs client actifs. Une tâche a un seul responsable, la personne chargée de la mener à bien. Transmettez clientId pour obtenir les responsables possibles d'un client. Sans clientId, vous obtenez les utilisateurs client de tous les clients accessibles avec la clé, chacun accompagné de son clientId, et les membres de l'équipe ne sont listés que si la clé et la personne qui l'a créée ont toutes deux accès à tous les clients. Les requêtes s'exécutent au nom de la personne qui a créé la clé d'API. Si Tâches et validations n'est pas activé pour votre espace de travail, la réponse est 404.

get/api/v1/work-management/owners
approvals:read
Paramètres de requête
clientIdstringfacultatif
Limite la liste à un client. Avec une clé qui a accès à tous les clients, accepte l'id, l'id public ou le slug du client, et un client auquel le créateur de la clé n'a pas accès renvoie 404. Avec une clé limitée à certains clients, passez l'id du client ; toute autre valeur, ou un client hors de l'accès de la clé, renvoie 403.
Réponse
okbooleanfacultatif
Toujours true pour une réponse réussie.
clientIdstringfacultatif
L'id du client si vous avez transmis clientId, sinon null.
ownersarray of objectfacultatif
Personnes pouvant être responsables d'une tâche : d'abord les membres de l'équipe, puis les utilisateurs client.
idstringfacultatif
L'id de la personne. Transmettez-le comme ownerId lors de la création d'une tâche, ou comme userId pour définir un responsable.
namestringfacultatif
Le nom affiché de la personne.
typestring (user | client_user)facultatif
user pour un membre de l'équipe de l'agence, client_user pour une personne d'un client. Envoyez la même valeur comme ownerType.
clientIdstringfacultatif
Le client auquel appartient cet utilisateur client. Uniquement pour les utilisateurs client.
emailstringfacultatif
L'adresse e-mail de l'utilisateur client, ou null. Uniquement pour les utilisateurs client.
Erreurs
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.
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é.
get/api/v1/work-management/owners
Votre clé API
clientId
{}

Vous débutez avec l'API Synup ?