Copiar Registro

Crie uma cópia de um registro existente enquanto preserva elementos de dados específicos.

Copiar um Registro

Para criar uma cópia de um registro existente enquanto mantém elementos específicos, use a mutação copyTodo:

mutation CopyTodo {
  copyTodo(
    input: {
      title: "new todo"
      todoId: "todo-id"
      todoListId: "todo-list-id"
      options: [
        DESCRIPTION
        DUE_DATE
        CHECKLISTS
        ASSIGNEES
        TAGS
        CUSTOM_FIELDS
        COMMENTS
      ]
    }
  )
}

Cabeçalhos Requeridos

x-bloo-token-id: "your-token-id"
x-bloo-token-secret: "your-token-secret" 
x-bloo-project-id: "project-id-or-slug"
x-bloo-company-id: "company-id-or-slug"

Parâmetros de Entrada

Campo	Tipo	Requerido	Descrição
title	String	Não	Novo título para o registro copiado (opcional)
todoId	String	Sim	ID do registro a ser copiado
todoListId	String	Sim	ID da lista onde criar a cópia
options	Array	Sim	Elementos de dados a serem copiados do registro original

Opções de Cópia

O array options aceita estes valores:

Opção	Descrição
DESCRIPTION	Copia a descrição do registro
DUE_DATE	Copia a data de vencimento e o fuso horário
CHECKLISTS	Copia todas as listas de verificação e seus itens
ASSIGNEES	Copia todos os usuários atribuídos (filtrados pela associação ao projeto de destino)
TAGS	Copia todas as tags associadas
CUSTOM_FIELDS	Copia todos os valores de campos personalizados (incluindo anexos de arquivos)
COMMENTS	Copia todos os comentários e respostas

Exemplo de Resposta

{
  "data": {
    "copyTodo": true
  }
}

Posicionamento das Cópias
A cópia do registro será colocada na parte inferior da lista de destino por padrão. Para controlar o posicionamento, use a [mutação mover registro](/api/records/move-record-list). ::

::callout
---
icon: i-heroicons-exclamation-triangle
---
Permissões Requeridas
Você precisa de permissões Editar (papel PROPRIETÁRIO, ADMIN ou MEMBRO) em ambos os projetos de origem e destino. Nota: Usuários com papel de MEMBRO podem copiar registros apenas dentro do mesmo projeto. A cópia entre projetos requer permissões ADMIN ou PROPRIETÁRIO. Cópias falhadas retornarão um código de erro `FORBIDDEN`.

Tratamento de Erros

Códigos de erro comuns para esta operação:

TODO_NOT_FOUND: todoId inválido ou inacessível
TODO_LIST_NOT_FOUND: todoListId inválido ou inacessível
FORBIDDEN: Permissões insuficientes ou restrição entre projetos

Veja Códigos de Erro para referência completa.

Recursos Avançados

Cópia entre Projetos

A mutação suporta a cópia de registros entre diferentes projetos com as seguintes considerações:

PROPRIETÁRIO/ADMIN: Pode copiar registros entre quaisquer projetos aos quais tenham acesso
MEMBRO: Restrito à cópia apenas dentro do mesmo projeto
Filtragem de Atribuições: Ao copiar entre projetos, os atribuídos são automaticamente filtrados para incluir apenas usuários que têm acesso ao projeto de destino

Tratamento de Campos Personalizados

Ao usar a opção CUSTOM_FIELDS:

Todos os valores de campos personalizados são copiados para o novo registro
Anexos de arquivos em campos personalizados são devidamente duplicados com novas referências de armazenamento
Tipos de campos personalizados são preservados e validados em relação à configuração do projeto de destino

Integração de Automação

Cópias entre projetos podem acionar regras de automação adicionais em ambos os projetos de origem e destino, permitindo uma gestão de fluxo de trabalho sofisticada através das fronteiras dos projetos.