Synup
Crear clave
v1Recursos/Approvals/putAsignar el responsable de una tarea

Asignar el responsable de una tarea

Convierte a una persona en responsable de una tarea y reemplaza a quien lo era antes. Cada responsable retirado queda en el historial de la tarea, y tanto el responsable anterior como el nuevo reciben un aviso. Usa GET /api/v1/work-management/owners para saber quién puede serlo. Un usuario de cliente solo puede ser responsable si la tarea tiene un cliente, y solo si es usuario de ese cliente. Cambiar el responsable mientras la tarea espera aprobación devuelve 409, así que primero retira la solicitud de aprobación. Una tarea fuera del acceso a clientes de la clave devuelve 403. Los reintentos con el mismo idempotencyKey y cuerpo devuelven el primer resultado con replayed en true. Si Tareas y aprobaciones no está activado en tu espacio de trabajo, devuelve 404.

put/api/v1/work-management/tasks/{id}/owner
approvals:write
Pará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*
{}

¿Nuevo en la API de Synup?