v1Recursos/Approvals/putAsignar el responsable de una tarea
Asignar el responsable de una tarea
Sustituye al responsable de la tarea por un miembro de agencia o usuario de cliente elegible. Quien llama y el nuevo responsable deben tener acceso según las restricciones actuales de clientes y proyectos privados. La asignación nunca concede acceso compartido. El usuario de cliente debe pertenecer al cliente de la tarea; no puede recibir tareas sin cliente. Se rechazan los cambios durante una revisión pendiente.
put
approvals:write/api/v1/work-management/tasks/{id}/ownerParámetros de consulta
idstringobligatorio
El id de la tarea, un UUID. Cualquier otro valor devuelve 404.
Cuerpo de la solicitud
idempotencyKeystringobligatorio
Una cadena única que eliges tú, de 8 a 200 caracteres. Reutilízala solo para reintentar la misma solicitud.
userIdstringobligatorio
El id del nuevo responsable, obtenido de GET /api/v1/work-management/owners.
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.
notestringopcional
Una nota opcional para el nuevo responsable, hasta 500 caracteres.
Respuesta
okbooleanopcional
Siempre true en una respuesta correcta.
dataobjectopcional
keystringopcional
La clave de la tarea, con el formato task:<id>.
assignmentIdstringopcional
El id de la asignación del responsable.
replacedintegeropcional
Cuántos responsables anteriores se retiraron. 0 si la persona ya era responsable de 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.
put/api/v1/work-management/tasks/{id}/owner
Su clave de API
id *
Cuerpo de la solicitud*
{}