v1Recursos/Approvals/postCrear una tarea
Crear una tarea
Crea una tarea en Tareas y aprobaciones. Una tarea es un trabajo que tu equipo sigue para un cliente, o para la propia agencia si omites clientId. En la misma llamada puedes asignar un responsable, un aprobador y hasta 25 subtareas; las subtareas que agregues aquí copian el responsable, el aprobador, la prioridad y las fechas de la tarea, salvo que les indiques los suyos. Para crear una subtarea de una tarea abierta existente, envía parentTaskId. Si el responsable es un usuario de cliente y omites clientId, la tarea se crea para el cliente de ese usuario. Puedes reintentar sin riesgo: enviar el mismo idempotencyKey con el mismo cuerpo devuelve el primer resultado con replayed en true, y reutilizar una clave con otro cuerpo devuelve 409. Si Tareas y aprobaciones no está activado en tu espacio de trabajo, devuelve 404.
post
approvals:write/api/v1/work-management/tasksCuerpo de la solicitud
idempotencyKeystringobligatorio
Una cadena única que eliges tú, de 8 a 200 caracteres. Reutilízala solo para reintentar la misma solicitud.
clientIdstringopcional
El cliente al que corresponde la tarea. Omítelo o envía null para trabajo de la agencia. Con una clave que llega a todos los clientes, acepta el id, el id público o el slug del cliente. 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. Una subtarea siempre comparte el cliente de su tarea principal, y indicar otro devuelve 400.
titlestringobligatorio
El título de la tarea, hasta 500 caracteres.
descriptionstringopcional
Lo que hay que hacer, hasta 20.000 caracteres.
locationIdstringopcional
Una ubicación del cliente de la tarea a la que se refiere la tarea. Una ubicación de otro cliente devuelve 400.
projectIdstringopcional
Un proyecto del mismo cliente en el que agrupar la tarea.
parentTaskIdstringopcional
Crea esta tarea como subtarea de una tarea existente. La tarea principal debe estar abierta y no puede ser una subtarea. La nueva subtarea toma el responsable, el aprobador, el proyecto, la ubicación, la prioridad, la fecha de vencimiento y la fecha de inicio de la principal, salvo que envíes los tuyos. No se puede combinar con subtasks.
metaobjectopcional
Prioridad y fecha de vencimiento. Envía ambos campos juntos. Por defecto, prioridad medium y sin fecha de vencimiento.
prioritystring (urgent | high | medium | low)obligatorio
Qué tan urgente es la tarea.
dueDatestringobligatorio
Fecha de vencimiento en formato YYYY-MM-DD en la zona horaria de tu espacio de trabajo, o null.
detailsobjectopcional
Etiquetas, fecha de inicio y estimación de tiempo.
labelsarray of stringopcional
Hasta 10 etiquetas de 40 caracteres cada una. Los duplicados que solo difieren en mayúsculas y minúsculas se unifican.
startDatestringopcional
Fecha de inicio en formato YYYY-MM-DD, o null. No puede ser posterior a la fecha de vencimiento.
estimatedMinutesintegeropcional
Esfuerzo estimado en minutos, o null.
subtasksarray of objectopcional
Hasta 25 subtareas para crear junto con la tarea. Cada una copia el responsable, el aprobador, la prioridad, la fecha de vencimiento y la fecha de inicio de la tarea, salvo que le indiques los suyos.
titlestringobligatorio
El título de la subtarea, hasta 200 caracteres.
descriptionstringopcional
Lo que cubre la subtarea, hasta 20.000 caracteres.
ownerIdstringopcional
El responsable de la subtarea. Omítelo para copiar el de la tarea, o envía null para dejarla sin responsable.
ownerTypestring (user | client_user)opcional
Si el responsable es un miembro del equipo de la agencia (user) o un usuario de cliente (client_user). Por defecto, user.
approverIdstringopcional
El aprobador de la subtarea. Omítelo para copiar el de la tarea, o envía null para no tener ninguno.
dueDatestringopcional
Fecha de vencimiento de la subtarea en formato YYYY-MM-DD, o null.
startDatestringopcional
Fecha de inicio de la subtarea en formato YYYY-MM-DD, o null.
prioritystring (urgent | high | medium | low)opcional
La prioridad de la subtarea.
ownerIdstringopcional
El id de la persona responsable de la tarea, obtenido de GET /api/v1/work-management/owners. Envía null para dejarla sin responsable. En una subtarea, si lo omites se copia el responsable de la principal.
ownerTypestring (user | client_user)opcional
Si el responsable es un miembro del equipo de la agencia (user) o un usuario de cliente (client_user). Por defecto, user.
approverIdstringopcional
El id de un miembro del equipo de la agencia que aprueba el trabajo de la tarea cuando alguien solicita aprobación. Envía null para no tener ninguno.
Respuesta
okbooleanopcional
Siempre true en una respuesta correcta.
dataobjectopcional
keystringopcional
La clave de la tarea, con el formato task:<id>.
rowVersionintegeropcional
El número de versión de la tarea. Aumenta cada vez que se edita la tarea.
replayedbooleanopcional
true cuando esta respuesta repite una solicitud anterior con el mismo idempotencyKey, por lo que no se guardó nada nuevo.
Errores
400Los 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.
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.
409Los 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.
post/api/v1/work-management/tasks
Su clave de API
Cuerpo de la solicitud*
{}