> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/tasks/copy-move.md).

# Copy or move task

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/tasks/copy-move.md).
{% endhint %}

Pick the group to copy or move a task to.

* **Where:** web: task detail, "Actions", then "Copy Task to Group" or "Move Task to Group" (dialog "Choose a group"). iOS: task detail menu, "Advanced Actions", then "Copy Task To Group" or "Move Task To Group". Android: task detail menu, "Copy Task to Group" or "Move Task to Group". Both apps also open this screen for an asset, with asset register wording ("Copy Asset to Asset Register" on Android); the web uses its own asset register dialog, part of [Asset detail](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-detail.md). Copying or moving several selected tasks uses a different sheet, part of [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md).
* **Who:** group admins of the task's group whose membership is active, while the task isn't locked, archived or outside its time range; the apps also hide it for planned tasks in the future. The target group must give the user "create tasks" permission, which admins of that group always have. The note on screen says "(Note: you must be an Admin in both Groups)", but no platform checks the admin role in the target group, and the API checks less than the apps \[[ASK-21](https://github.com/snapfix/docs/blob/main/ASK.md#ask-21-who-may-copy-or-move-a-task-and-what-should-the-tag-options-do)].
* **Feature:** [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md)

![Copy or move task](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-806ac134ad6ef4ede6d02f4e0df820869e3a1d9e%2Fcopy-move.png?alt=media)

## Layout

Web (a dialog 480 px wide):

1. **Header:** "Choose a group" and a close button, hidden while the copy or move runs.
2. **Text:** "Choose the Group to copy the Task into" (or "move"), then "(Note: you must be an Admin in both Groups)".
3. **"Search Groups"** box.
4. **Group list:** one radio row per group, with the group image, name and address. The task's own group is left out. Archived groups show as disabled and can't be picked; the Groups tab leaves them out, so this list can be longer than its count.
5. **Footer:** "Cancel" and "Save".

iOS and Android (a full screen):

1. **Top bar:** back and "Choose a Group".
2. **"Search"** box.
3. **Text:** "Choose the Group to copy the Task into" or "Choose the Group to move the Task into" (Android: "...move the task into"), then "(Note: you must be an Admin in both Groups)". For assets: "Choose the Asset Register to copy the Asset into" and "(Note: you must be an Admin in both Asset Registers)" on Android.
4. **Group list:** the user's groups on the current site, of the same kind (task groups or asset registers), without the task's own group, sorted by name. Each row has the group image, name, address and a selection mark. Archived groups show as disabled. There is no save button: tapping a row goes straight to the confirmation.

## Inputs

| Field                                     | Type                        | Required | Default | Rules and messages                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------------------------------- | --------------------------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search                                    | Text                        | No       | Empty   | Web: searches group names on the server and reloads the list. iOS: filters the loaded list by the group's search text; Android: by name. Case-insensitive                                                                                                                                                                                                                                                                                                                                            |
| Group                                     | Single choice               | Yes      | None    | Archived groups can't be picked. Without "create tasks" permission in the picked group: web shows "Access denied" with "Oops, you don't have the right permissions to create task in this group. Reach out to the group admin to review your permissions."; iOS and Android show "You don’t have the permission to create task in this group. Reach out to the group admin to review your permission." (also for an inactive membership). Web: "Save" stays disabled until a group passes this check |
| "Users"                                   | Switch, in the confirmation | No       | On      | On: followers who aren't members of the target group become members, with the role and permissions they have in the source group. Off: only followers and assignees already in the target group come along                                                                                                                                                                                                                                                                                           |
| "Tag folders" (web), "Tag Folders" (apps) | Switch, in the confirmation | No       | On      | On: the target group gets the task's tag folders, and all tags come along. Off: the copy gets no tags at all \[[ASK-21](https://github.com/snapfix/docs/blob/main/ASK.md#ask-21-who-may-copy-or-move-a-task-and-what-should-the-tag-options-do)]. Hidden for asset registers                                                                                                                                                                                                                         |

## Actions

| Action                     | Who      | What happens                                                                                                                                                                                                                                                                                                                                                          | API                                                                                                                                                                                                                                                  |
| -------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the dialog (web)      | As above | Loads the groups 20 at a time, sorted by name, more on scroll                                                                                                                                                                                                                                                                                                         | [`GET /v1/app/businesses`](https://docs.snapfix.com/engineering-reference/api/groups.md)                                                                                                                                                             |
| Pick a group (web)         | As above | Loads the group's users and tags, then checks the permission                                                                                                                                                                                                                                                                                                          | [`GET /v1/app/businesses/{uuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md)                                                                                                                                                      |
| "Save" (web)               | As above | If the task has no assignees, followers or tags, the copy or move starts at once. Otherwise the confirmation opens                                                                                                                                                                                                                                                    | -                                                                                                                                                                                                                                                    |
| Tap a group (iOS, Android) | As above | Checks the permission, then opens the confirmation. iOS ignores taps on archived groups without a message                                                                                                                                                                                                                                                             | -                                                                                                                                                                                                                                                    |
| Confirm a copy             | As above | Creates a new task in the target group titled "Boiler leak Copy", with a new reference number. It brings the chat with its reactions, the checklist with its photos, assets, rooms, areas, time and cost, followers and assignees, and tags as the switches allow, and adds "Task copied from 'Kitchen'. Nov 11 2026 14:30" to its chat. The original stays as it was | Web: [`POST /v1/app/tasks/copy`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskscopy). iOS and Android: [`POST ?action=copy_job_v2`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actioncopy_job_v2) |
| Confirm a move             | As above | Creates the same new task without "Copy" in the title, adds "Task moved from 'Kitchen'. Nov 11 2026 14:30" to its chat, and deletes the original. The task gets a new ID, so links to the old one, including share links, point at the deleted original                                                                                                               | Web: [`POST /v1/app/tasks/move`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmove). iOS and Android: [`POST ?action=move_job_v2`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionmove_job_v2) |
| Cancel, close or back      | Anyone   | Closes without changes                                                                                                                                                                                                                                                                                                                                                | -                                                                                                                                                                                                                                                    |

After a copy, the web dialog closes and the task stays open; the apps show "Task copied successfully" and go back to the task. After a move, the web opens the list the user came from (group, room or area), and the apps show "Task moved successfully" and open the source group's task list. Both apps also mark the original task deleted in their local copy and sync that.

## States

* **Loading:** web: a spinner in the list while groups load, and at the bottom while more load; the search box is disabled until the list and the picked group's details have loaded. While the copy or move runs, "Save" shows progress and the dialog can't be closed. iOS shows "Copying task..." or "Moving task..." over the screen; Android a progress dialog with the same text ("Copying asset..." and "Moving asset..." for assets).
* **Empty:** web: "No data available". iOS and Android show an empty list.
* **Error:** web: the button returns to normal; the message comes from the shared error handling. iOS: the API's message, or "Something went wrong. Please try again.". Android: the API's message; when the session token has expired it refreshes it and retries.
* **No permission:** the menu items are hidden; a group without "create tasks" permission shows the messages under Inputs.
* **Offline (mobile):** the list works from the local data. Confirming shows "You must be connected to the Internet to carry out this task. Please connect and try again." (under the title "No Connection" on iOS) and nothing is sent.

## Dialogs and sheets

**Confirmation (web, "Confirm Copy" or "Confirm Move").** Opens after "Save" when the task has assignees, followers or tags.

* Message: "This task will be copied to the following Group: Kitchen" (or "moved"). When some followers, assignees or tags aren't in the target group, it lists them instead: "The tags/users listed below do not exist in the chosen Group.", then "Users" and "Tags" lists, then "By confirming, these will be created in the chosen Group."
* The "Users" and "Tag folders" switches (see Inputs).
* "Cancel" closes it and keeps the dialog open; "Confirm" starts the copy or move.

**Confirmation (iOS and Android).** A bottom sheet that opens on every tap of a group.

* Title: "Copy Task To Group" or "Move Task To Group" (Android: "Copy Task to Group", "Move Task to Group"; for assets "Copy Asset to Asset Register", "Move Asset to Asset Register").
* Message: "The Task you are copying may include Users and Tags that do not exist in the "Kitchen" Group. Choose if you want to add those Users and Tags in the "Kitchen" Group." (or "moving"). For assets: "The Asset you are copying may include Users that do not exist in the "Kitchen" Asset Register. Choose if you want to add those Users in the "Kitchen" Asset Register." It doesn't name the missing users or tags.
* The "Users" and "Tag Folders" switches; "Tag Folders" is hidden for assets.
* "Cancel" and "Confirm Copy" or "Confirm Move" (iOS), "Cancel" and "Confirm" (Android). Android also has a close button.

## Platform differences

* **Backend:** the web calls the Laravel API and the apps call php-apis, and the results differ. Only the web copies compliance systems, the task's status history and planned task schedules linked to it, and moves linked cleaning and inspection tasks along. Only the apps copy the task's reminders.
* **Flow:** the web picks a group and then "Save"; the apps go to the confirmation on tap. The web skips the confirmation for a task without users or tags and lists what is missing; the apps always confirm and never list it.
* **Group list:** the web loads groups from the server with paging and server-side search; the apps use the groups stored on the device.
* **Picking a refused group (web):** after the "Access denied" message the radio stays on the refused group, but "Save" still uses the group picked before it. Only the short confirmation ("This task will be copied to the following Group: ...") names that group; the list of missing users and tags doesn't, and a task without users or tags skips the confirmation.
* **Menu labels:** web "Copy Task to Group" and "Move Task to Group" under "Actions", each with an info popover ("Makes a copy of this Task in another Group. Note that the Tag Headings and Users must exist in both groups before the copy will complete."). iOS uses "Copy Task To Group" under "Advanced Actions", and both apps show "Both groups must have the same Tag Headings (e.g. Location, Equipment, Category) to be able to copy a Task from one Group to another Group." No platform checks the tag headings any more \[[ASK-21](https://github.com/snapfix/docs/blob/main/ASK.md#ask-21-who-may-copy-or-move-a-task-and-what-should-the-tag-options-do)].


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/tasks/copy-move.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
