v1Recursos/Approvals/putDefinir o responsável por uma tarefa
Definir o responsável por uma tarefa
Torna uma pessoa responsável por uma tarefa, substituindo quem era antes. Cada responsável removido fica no histórico da tarefa, e tanto o responsável anterior quanto o novo recebem um aviso. Use GET /api/v1/work-management/owners para saber quem pode ser responsável. Um usuário de cliente só pode ser responsável quando a tarefa tem um cliente, e somente se for usuário desse cliente. Trocar o responsável enquanto a tarefa aguarda aprovação retorna 409, então retire a solicitação de aprovação antes. Uma tarefa fora do acesso a clientes da chave retorna 403. Repetições com o mesmo idempotencyKey e corpo retornam o primeiro resultado com replayed igual a true. Se Tarefas e aprovações não estiver ativado no seu workspace, retorna 404.
put
approvals:write/api/v1/work-management/tasks/{id}/ownerParâmetros de consulta
idstringobrigatório
O id da tarefa, um UUID. Qualquer outro valor retorna 404.
Corpo da solicitação
idempotencyKeystringobrigatório
Uma string única que você escolhe, de 8 a 200 caracteres. Reutilize-a apenas para repetir a mesma solicitação.
userIdstringobrigatório
O id do novo responsável, obtido em GET /api/v1/work-management/owners.
ownerTypestring (user | client_user)opcional
Se o responsável é um membro da equipe da agência (user) ou um usuário de cliente (client_user). O padrão é user.
notestringopcional
Uma nota opcional para o novo responsável, até 500 caracteres.
Resposta
okbooleanopcional
Sempre true em uma resposta bem-sucedida.
dataobjectopcional
keystringopcional
A chave da tarefa, no formato task:<id>.
assignmentIdstringopcional
O id da atribuição do responsável.
replacedintegeropcional
Quantos responsáveis anteriores foram removidos. 0 quando a pessoa já era responsável pela tarefa.
replayedbooleanopcional
true quando esta resposta repete uma solicitação anterior com o mesmo idempotencyKey, então nada novo foi salvo.
Erros
400Os erros de Tarefas e aprovações retornam ok: false com um objeto error contendo code, message, retryable e details. Os erros da própria verificação da chave de API (chave ausente ou inválida, scope ausente, limite de requisições) usam o formato padrão, em que error é uma string.
401Chave de API ausente, inválida, expirada ou revogada.
403Os erros de Tarefas e aprovações retornam ok: false com um objeto error contendo code, message, retryable e details. Os erros da própria verificação da chave de API (chave ausente ou inválida, scope ausente, limite de requisições) usam o formato padrão, em que error é uma string.
404Os erros de Tarefas e aprovações retornam ok: false com um objeto error contendo code, message, retryable e details. Os erros da própria verificação da chave de API (chave ausente ou inválida, scope ausente, limite de requisições) usam o formato padrão, em que error é uma string.
409Os erros de Tarefas e aprovações retornam ok: false com um objeto error contendo code, message, retryable e details. Os erros da própria verificação da chave de API (chave ausente ou inválida, scope ausente, limite de requisições) usam o formato padrão, em que error é uma string.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
500Não foi possível concluir a requisição por um problema do nosso lado.
put/api/v1/work-management/tasks/{id}/owner
Sua chave de API
id *
Corpo da solicitação*
{}