v1Recursos/Approvals/putDefinir o responsável por uma tarefa
Definir o responsável por uma tarefa
Substitui o responsável da tarefa por um membro da agência ou usuário do cliente elegível. Quem faz a chamada e o novo responsável já devem ter acesso conforme as restrições atuais de clientes e projetos privados. A atribuição nunca concede compartilhamento. Um usuário do cliente deve pertencer ao cliente da tarefa; tarefas sem cliente não podem ser atribuídas a ele. Alterações são recusadas durante uma revisão pendente.
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*
{}