Crie uma cópia de um registro existente enquanto preserva elementos de dados específicos.
Copy page in markdown for LLMs
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`.
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ívelTODO_LIST_NOT_FOUND: todoListId inválido ou inacessívelFORBIDDEN: 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.