v1Recursos/Approvals/postAtualizar campos de tarefas
Atualizar campos de tarefas
Cria, renomeia ou arquiva um campo personalizado de Tarefas, ou define valores nas tarefas que o criador da chave pode ver. Envie um mutationId e um command. Os campos são compartilhados em todo o espaço de trabalho. Os erros usam o formato de erro de Tarefas e aprovações.
post
approvals:write/api/v1/work-management/tasks/fieldsCorpo da solicitação
mutationIdstringobrigatório
Um UUID que você escolhe para esta alteração. Reenviá-lo com o mesmo command retorna o primeiro resultado sem aplicar a alteração de novo; reutilizá-lo com um command diferente retorna 409.
commandobjectobrigatório
Uma alteração. field_create adiciona um campo com label, type e options. field_update renomeia um campo, altera suas opções ou o arquiva ou restaura, e exige a versão atual do campo como expectedVersion. values_update define de 1 a 1000 valores, cada um com recordId, fieldId, value e expectedVersion, e aplica todos ou nenhum. Uma opção que registros ainda usam não pode ser removida; arquive-a em vez disso. Um conjunto de campos comporta no máximo 40 campos, incluindo os arquivados.
Erros
400A requisição é inválida, por exemplo um command malformado, um corpo acima de 1 MB ou um valor que não se ajusta ao campo.
401Chave de API ausente, inválida, expirada ou revogada.
403O criador da chave não tem permissão para usar os campos de tarefas.
404A tarefa ou o campo não está disponível para o criador da chave.
409Um campo ou um de seus valores armazenados mudou desde que você o leu, já existe um campo com esse nome, ou o mutationId já foi usado com um command diferente.
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.
503O serviço está temporariamente indisponível. Tente novamente mais tarde.
post/api/v1/work-management/tasks/fields
Sua chave de API
Corpo da solicitação*
{}