v1Recursos/Approvals/postCrear una tarea
Crear una tarea
Crea una tarea o subtarea con el acceso actual del creador del token, limitado por las restricciones de clientes del token. Las tareas de proyectos privados heredan su acceso; las subtareas heredan las restricciones de su tarea principal. Los responsables y aprobadores deben tener acceso previamente. Crear una tarea sin responsable o sin cliente no la hace privada por sí solo. Una persona gestiona el uso compartido del proyecto en la aplicación, no mediante este endpoint.
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*
{}