v1Recursos/Approvals/getListar responsables de tareas
Listar responsables de tareas
Devuelve las personas que pueden ser responsables de una tarea en Tareas y aprobaciones: miembros del equipo de la agencia con acceso a Tareas y aprobaciones, y usuarios de cliente activos. Una tarea tiene un solo responsable, la persona encargada de completarla. Envía clientId para obtener los responsables de un cliente. Sin clientId, recibes los usuarios de cliente de todos los clientes a los que llega la clave, cada uno con su clientId, y los miembros del equipo solo aparecen cuando tanto la clave como la persona que la creó tienen acceso a todos los clientes. Las solicitudes se ejecutan como la persona que creó la clave de API. Si Tareas y aprobaciones no está activado en tu espacio de trabajo, devuelve 404.
get
approvals:read/api/v1/work-management/ownersParámetros de consulta
clientIdstringopcional
Limita la lista a un cliente. Con una clave que llega a todos los clientes, acepta el id, el id público o el slug del cliente, y un cliente al que no tiene acceso el creador de la clave devuelve 404. Con una clave limitada a clientes concretos, pasa el id del cliente; cualquier otro valor, o un cliente fuera del acceso de la clave, devuelve 403.
Respuesta
okbooleanopcional
Siempre true en una respuesta correcta.
clientIdstringopcional
El id del cliente si enviaste clientId; si no, null.
ownersarray of objectopcional
Personas que pueden ser responsables de una tarea: primero los miembros del equipo y después los usuarios de cliente.
idstringopcional
El id de la persona. Envíalo como ownerId al crear una tarea, o como userId al asignar un responsable.
namestringopcional
El nombre visible de la persona.
typestring (user | client_user)opcional
user para un miembro del equipo de la agencia, client_user para una persona de un cliente. Envía el mismo valor como ownerType.
clientIdstringopcional
El cliente al que pertenece este usuario de cliente. Solo en usuarios de cliente.
emailstringopcional
El correo electrónico del usuario de cliente, o null. Solo en usuarios de cliente.
Errores
401La clave de API falta, es inválida, expiró o fue revocada.
403Los errores de Tareas y aprobaciones llegan como ok: false con un objeto error que contiene code, message, retryable y details. Los errores de la propia comprobación de la clave de API (clave ausente o no válida, scope ausente, límite de solicitudes) usan el formato estándar, en el que error es un string.
404Los errores de Tareas y aprobaciones llegan como ok: false con un objeto error que contiene code, message, retryable y details. Los errores de la propia comprobación de la clave de API (clave ausente o no válida, scope ausente, límite de solicitudes) usan el formato estándar, en el que error es un string.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
500No se pudo completar la solicitud por un problema de nuestra parte.
get/api/v1/work-management/owners
Su clave de API
clientId
{}