v1Ressources/Approvals/getLister les responsables de tâches
Lister les responsables de tâches
Liste les responsables possibles selon les accès actuels du créateur du jeton à l’espace de travail et aux clients. Cette liste ne donne aucun accès aux projets privés et ne garantit pas l’éligibilité à une tâche précise. L’attribution vérifie à nouveau les accès ; attribuer une tâche ou mentionner une personne ne partage jamais un travail privé.
get
approvals:read/api/v1/work-management/ownersParamè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
{}