v1Recursos/Approvals/getObtener una tarea
Obtener una tarea
Devuelve una tarea o subtarea de Tareas y aprobaciones por su id: estado, responsable, estado de aprobación, fechas y rowVersion. Una tarea que no existe, o que pertenece a un cliente fuera del acceso de la clave, devuelve 404. Si Tareas y aprobaciones no está activado en tu espacio de trabajo, devuelve 404.
get
approvals:read/api/v1/work-management/tasks/{id}Parámetros de consulta
idstringobligatorio
El id de la tarea, un UUID. Cualquier otro valor devuelve 404.
Respuesta
okbooleanopcional
Siempre true en una respuesta correcta.
deliveryAvailablebooleanopcional
Si este espacio de trabajo puede entregar contenido aprobado. Puede no venir.
itemobjectopcional
La tarea.
keystringopcional
La clave de la tarea, con el formato task:<id>.
itemIdstringopcional
El id de la tarea.
kindstring (task | subtask)opcional
task para una tarea principal, subtask para una subtarea.
titlestringopcional
El título de la tarea.
descriptionstringopcional
La descripción de la tarea, o null.
statusstring (open | in_progress | awaiting_decision | approval_required | revision_requested | approved | rejected | done | dismissed)opcional
En qué punto está la tarea. approval_required significa que espera a su aprobador.
clientIdstringopcional
El cliente de la tarea, o null para trabajo de la agencia.
locationIdstringopcional
La ubicación a la que se refiere la tarea, o null.
projectIdstringopcional
El proyecto al que pertenece la tarea, o null.
projectNamestringopcional
El nombre del proyecto, o null.
parentKeystringopcional
En una subtarea, la clave de la tarea principal; si no, null.
ownersarray of objectopcional
El responsable de la tarea, en forma de lista. Las tareas nuevas tienen como máximo uno; las más antiguas pueden mostrar varios.
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.
avatarUrlstringopcional
La URL de la foto de perfil de la persona, si existe.
creatorobjectopcional
Quién creó la tarea: un miembro del equipo o un usuario de cliente. null si se desconoce.
idstringopcional
namestringopcional
typestring (user | client_user)opcional
manualApprovalobjectopcional
El aprobador de la tarea y el estado de su solicitud de aprobación.
approverobjectopcional
El id, el nombre y el tipo del aprobador, o null si no hay.
statestring (approval_required | approved)opcional
approval_required mientras una solicitud espera al aprobador, approved una vez aprobada; si no, null.
requestIdstringopcional
El id de la solicitud de aprobación pendiente, o null.
feedbackstringopcional
El motivo del aprobador cuando pidió cambios, mientras la tarea vuelve a estar abierta. Si no, null.
detailsobjectopcional
Etiquetas, fecha de inicio, estimación de tiempo y archivos adjuntos.
labelsarray of stringopcional
startDatestringopcional
estimatedMinutesintegeropcional
attachmentsarray of objectopcional
keystringopcional
namestringopcional
mimestringopcional
sizeintegeropcional
prioritystring (urgent | high | medium | low)opcional
La prioridad de la tarea, o null.
dueAtstringopcional
Cuándo vence la tarea, en UTC, o null.
createdAtstringopcional
Cuándo se creó la tarea, en UTC.
updatedAtstringopcional
Cuándo cambió la tarea por última vez, en UTC.
completedAtstringopcional
Cuándo se terminó la tarea, en UTC, o null.
blockedByarray of stringopcional
Claves de elementos abiertos que deben terminarse antes de esta tarea.
openSubtaskCountintegeropcional
Cuántas de sus subtareas siguen abiertas.
commentCountintegeropcional
Cuántos comentarios tiene la tarea.
rowVersionintegeropcional
El número de versión de la tarea. Aumenta cada vez que se edita la tarea.
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/tasks/{id}
Su clave de API
id *
{}