> 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/task-detail.md).

# Task detail

{% 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/task-detail.md).
{% endhint %}

One task on one screen: people change its status and priority, assign and follow it, tag it, set its due date, reminder, time range, time and cost, fill in its checklist, approve or reject it, and talk about it in the task chat.

* **Where:** web `/group/:id/task/:taskId`, `/room/:id/task/:taskId` and `/area/:id/task/:taskId`; iOS `MessagesVC` inside the task pager `MessageSwipeCollectionView`; Android `JobChatFragment` inside `JobChatActivity`. All ways in are under [Getting here](#getting-here). The same code also shows assets of asset registers ([Asset detail](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-detail.md)).
* **Who:** group admins, users with "View All Tasks", the task's creator, its assigned users and followers, and the site's multi-site users can open it; the API refuses everyone else ("Access denied"). What each person can change depends on their group role and permissions: [Who can do what](#who-can-do-what).
* **Feature:** [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md); also [Task chat](https://docs.snapfix.com/product/features/chat/task-chat.md), [Task approval](https://docs.snapfix.com/product/features/tasks/task-approval.md), [Sharing tasks](https://docs.snapfix.com/product/features/tasks/task-sharing.md), [Time and cost](https://docs.snapfix.com/product/features/tasks/time-and-cost.md), [Reminders](https://docs.snapfix.com/product/features/notifications/reminders.md), [Checklists](https://docs.snapfix.com/product/features/checklists/checklists.md) and [Cleaning tasks](https://docs.snapfix.com/product/features/housekeeping/cleaning-tasks.md)

![Task detail](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-aa5bd55a6049abc97e4f3493da137718500e1bbc%2Ftask-detail.png?alt=media)

## Getting here

* **From a list.** Web: a task in [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md), the [Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md), a [room](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room.md) or an [area](https://docs.snapfix.com/how-the-apps-work/screens/rooms/area.md); the URL follows the list (the Feed opens `/group/<task's group>/task/<task>`). iOS and Android: a task in any task list.
* **Next and previous.** Web: "Previous" and "Next" in the title bar walk through the list the user came from (the group's task list or the Feed). iOS and Android: arrow buttons do the same. Swiping between tasks is switched off on both apps: iOS never sets the pager's data source and its swipe gesture returns early; Android turns off user input on its `ViewPager2`. iOS hides the arrows when the task was opened from a room or an area, or alone. Android opens a single task without arrows from notifications, the Feed, rooms, areas and the schedule.
* **From a notification.** iOS opens the task, downloads it again and scrolls to the newest message. Android scrolls to the message the notification is about and highlights it. Notification routing belongs in [shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md).
* **From a link.** Web opens any task URL directly; Android opens a task from a link that carries its ID (`JobUUID`).
* **Other ways in.** Web: a new task opens here right after it's created in [Add a Task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md), with Snapfix AI suggestions running (see [Users, tags, rooms, assets and compliance](#users-tags-rooms-assets-and-compliance)), and an inspection task's "Parent Tasks" card opens its cleaning task. iOS and Android: the first task a user creates opens here with a first-task popup (iOS `FirstTaskCreatedPopupVC`, Android `FirstTaskCompleteBottomSheet`).
* **Back.** Returns to the list the task was opened from. The apps record that the user viewed the task when they leave.

## Who can do what

A **group admin** has role "Admin" in the task's group. Other members have role "User" plus per-user permissions set in [Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md): "Create New Task", "Change task to red", "Change task to yellow", "Change task to green", "View All Tasks", "Hide Task Notes", "Delete or Archive Tasks", "Access Attachments", "Assign Users", "Generate Reports" and "Create Planned Tasks". Group admins pass every permission check. A **read-only user** ("Read-only user" in group settings) can open tasks but change nothing. Both apps treat people who aren't in the group as read-only.

**Editable** below means all of these:

* the task isn't locked or archived,
* the user isn't read-only,
* if the task has a time range, the current time is inside it; tasks placed by housekeeping assignment ignore the range (on the web, every cleaning and inspection task does),
* on iOS and Android, the task wasn't created ahead of its day (a planned occurrence).

| Action                                                                                                                           | Web                                                                                               | iOS                                                                          | Android                                                   |
| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------- |
| Change status                                                                                                                    | Editable, and the matching "Change task to …" permission                                          | Same                                                                         | Same                                                      |
| Rename, notes, priority, large text, tags, rooms, areas, assets, compliance system, due date, reminder, time and cost, checklist | Editable; notes also for read-only users and outside the time range                               | Editable                                                                     | Editable                                                  |
| Assign users and followers                                                                                                       | Editable and "Assign Users" (inspection tasks also while locked)                                  | Same                                                                         | Same                                                      |
| Change the task image                                                                                                            | Editable, group admin or the creator, and the group allows gallery photos                         | Editable, group admin or the creator                                         | Same as iOS                                               |
| Remove a linked asset                                                                                                            | Editable                                                                                          | Group admins only                                                            | Editable                                                  |
| Set the time range                                                                                                               | Group admins                                                                                      | Group admins; an assigned housekeeper gets the housekeeping schedule instead | Same as iOS                                               |
| Require approval                                                                                                                 | Group admins                                                                                      | Group admins                                                                 | Group admins                                              |
| Approve or reject                                                                                                                | Group admins, and the assigned users of an inspection task                                        | Same                                                                         | Same                                                      |
| Copy or move to another group                                                                                                    | Group admins                                                                                      | Group admins                                                                 | Group admins                                              |
| Duplicate                                                                                                                        | "Create New Task"                                                                                 | Same                                                                         | Same                                                      |
| Create a planned task from the task                                                                                              | "Create Planned Tasks" and "Create New Task"                                                      | Same                                                                         | Same                                                      |
| Lock or unlock                                                                                                                   | Editable, ignoring the lock                                                                       | Group admins and the creator                                                 | Same as iOS                                               |
| Archive or unarchive                                                                                                             | "Delete or Archive Tasks"; a task that is both archived and locked offers "Unarchive" to everyone | "Delete or Archive Tasks"                                                    | Same as iOS                                               |
| Delete                                                                                                                           | "Delete or Archive Tasks", also on locked, archived or out-of-range tasks                         | Same, but out of range only group admins                                     | Same, but out of range everyone, read-only users included |
| Send messages, photos and videos                                                                                                 | Editable                                                                                          | Editable                                                                     | Editable                                                  |
| Send and open documents                                                                                                          | "Access Attachments"                                                                              | Same                                                                         | Same                                                      |
| Delete a message                                                                                                                 | Group admins any message, others their own                                                        | Group admins only                                                            | Same as iOS                                               |
| See notes                                                                                                                        | Everyone in the group except users with "Hide Task Notes"                                         | Everyone except users with "Hide Task Notes"                                 | Same as iOS                                               |
| Share                                                                                                                            | Everyone who can open the task                                                                    | Same                                                                         | Same                                                      |

The API applies its own rules ([`JobPolicy`, see the Tasks API](https://docs.snapfix.com/engineering-reference/api/tasks.md#put-v1apptasksuuid)): changing fields needs one of the roles under **Who** and not read-only; status needs the color permission or being assigned to the task; lock needs group admin or creator; archive and delete need "Delete or Archive Tasks"; approval needs group admin or being assigned. Refused requests show "Access denied". The apps send most changes through the offline queue instead (see [States](#states)).

## Layout

### Web

1. **Header.** A back button. The group's image and name, which open the group's details ([Group purpose](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-purpose.md)); a "Settings" gear for users with "Group Settings Access"; an AI badge while Snapfix AI suggestions show; with a multi-site selected, the site's name. Opened from a room or an area, the header shows that room or area instead.
2. **Title bar.** The task name (two lines at most, machine-translated when the site has translation on) with an edit pencil. On the right: the due date (with "Overdue" once passed, tooltip "This task is due on …" or "This task was due on …"); the traffic light, three status buttons whose tooltips are the group's definition of each status; the icon buttons "Share" and "Actions" (named by their tooltips; "Actions" is a three-dot menu, shown only when the user has at least one action); "Previous" and "Next".
3. **Left column.**
   * The task image: the photo, the large text, or for housekeeping tasks the room's name. While the task isn't locked or archived, a quick-action bar sits on it: a tag button (menu "Areas & Rooms", one item per tag folder, "Assets"), the users button, the reminder bell, the due date button and the priority star ("1" or "2" once set). A pencil appears for large-text tasks and a map button when the task has a location. Clicking the image opens [Task image](#task-image).
   * "Notes", a collapsible card.
   * "Reservation Details" (collapsed) for every task with a room: the hotel system's details for the task's first room, such as "Room Number", "Floor", "Occupancy", "Guest name", "Booking reference", "Arrival", "Departure", "ETA", "ETD", "VIP Booking", "VIP Code", "Preferences", "HK traces" and "Room note". The API sends this block for a room without a booking too.
   * "Details": "Created by", "Created", "Last updated by", "Last update", and "Task #" with the reference number. One site, picked by a hard-coded ID, sees "PO Number" instead.
   * "Last viewed" (collapsed): who opened the task and when.
   * "Activity" (collapsed): every audit line, grouped by day ("Today"), 20 at a time as the user scrolls. A "task created from chat" line has "View Chat", which opens the chat message the task came from. iOS and Android show this log on a separate screen, [Task activity](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-activity.md).
4. **Center column.** The "Approval Request" card when approval is pending and the user may review it, then "Messages", the [task chat](#task-chat).
5. **Right column**, top to bottom: the checklist card (or "Checklist" with "+"), with the signature box when the checklist needs one; "Users" ("Created by", "Assigned to", "Followed by"); "Parent Tasks" (an inspection task's cleaning task); "Tags", one sub-section per tag folder; "Assets"; "Areas & Rooms"; "Compliance System"; "Time Range" (always for group admins, for others only once set); "Cost" and "Time" with totals and "Download Statement Of Fees"; "Reminder".

### iOS and Android

1. **Toolbar.** Back, the task name (tap to rename), the status control (tap to see all three colors), buttons for priority, due date, reminder, tags, users and the task menu, and the next and previous arrows. Android adds an offline icon with the number of tasks waiting to sync ("You are offline. The count indicates the number of tasks to be updated when you are online.").
2. **Header card**, which scrolls away with the chat: the task image (photo, large text, or the room's name for housekeeping tasks) with an image menu ("Download", "Share", "Map", "Change Image"); the group; the checklist card ("Add Checklist" when there is none); "Notes"; assigned users; tags; area and room; compliance system; linked assets; attributes (asset registers only); time range ("Start time", "End time"); time and cost; reservation details; AI badges on suggested values. iOS loads these images while accepting invalid certificates.
3. **Housekeeping card** on cleaning and inspection tasks: "Snooze" (Android shows the disabled "Task Snoozed" once snoozed) and, on inspection tasks, the parent cleaning task.
4. **Approval card** for reviewers while a task waits for approval: "Approval Request", who asked and when, and approve and reject buttons.
5. **Task chat**, grouped by day.
6. **Composer**, shown only while the task is editable: camera, "Add a message", send (replaces the camera once text is typed), a hold-to-record voice button and "+". iOS adds an NFC button on devices with NFC. A reply preview sits above it while replying.

### Task chat

The chat mixes people's messages with system lines. The web loads 20 messages at a time, newest first, and appends new lines as people act. The apps read the chat from the device's database, which the sync service and live updates (Firebase) keep current. Other audit lines (tags, users, title, notes, location, due date, reminders, time and cost, rooms, areas, assets, checklist items) appear only in the activity log.

| Code       | Message                                 | Shown as                                                                                                                                                                                                                                                                                                                                                      |
| ---------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1          | Text                                    | A bubble; own messages on the other side; links are clickable. Web, iOS and Android translate other people's text when the site has translation on ("See original", "Show translation"; Android says "Show translations"). A reply shows the quoted message on top; tapping the quote scrolls to it, and a deleted original reads "Message has been deleted". |
| 2, 3       | Drawing, photo                          | The image; opens the [Gallery](https://docs.snapfix.com/how-the-apps-work/screens/tasks/gallery.md). The apps add a "+" button that starts a new task from it.                                                                                                                                                                                                |
| 5          | Video                                   | A thumbnail with a play icon; opens the gallery; the apps add the "+" button too.                                                                                                                                                                                                                                                                             |
| 36         | Document                                | The file name with a file-type icon. Opens with "Access Attachments"; without it the web says "Viewing attachments has been disabled. Contact your administrator".                                                                                                                                                                                            |
| 37         | Voice note                              | A player with a waveform. The web shows "Unable to play the voice message" when it can't load. The apps show a transcript when there is one.                                                                                                                                                                                                                  |
| 6          | Task created                            | A card with the group's definition of the starting status.                                                                                                                                                                                                                                                                                                    |
| 19, 61     | Status changed, automatic status change | A card with the new status's definition and color. Type 61 is the automatic change to amber or green when the checklist starts or completes. Repeats of the same status in a row are hidden.                                                                                                                                                                  |
| 31         | Planned task                            | A card.                                                                                                                                                                                                                                                                                                                                                       |
| 32         | NFC scan                                | A card.                                                                                                                                                                                                                                                                                                                                                       |
| 42         | Checklist signature                     | The signature.                                                                                                                                                                                                                                                                                                                                                |
| 66, 67, 68 | Time range set, updated, removed        | "Time Range Set" or "Time Range Updated" with the start time and "Duration", or "Time Range UnSet".                                                                                                                                                                                                                                                           |
| 69, 70     | Copied, moved                           | A card.                                                                                                                                                                                                                                                                                                                                                       |
| 81         | Task created from a chat                | iOS shows it in the chat, with "View Chat"; the web only in "Activity".                                                                                                                                                                                                                                                                                       |
| 86, 87, 88 | Sent for approval, approved, rejected   | "Sent for Approval", "Task Approved", "Task Rejected".                                                                                                                                                                                                                                                                                                        |
| 89         | Rejection note                          | A text bubble from the reviewer.                                                                                                                                                                                                                                                                                                                              |
| 91         | Snoozed                                 | The snooze reason and note.                                                                                                                                                                                                                                                                                                                                   |
| 500        | Sensor (IoT) message                    | Apps only: the first line, with "more" opening [IoT message](#iot-message).                                                                                                                                                                                                                                                                                   |

Reactions sit under a message: six emoji, the same set on every platform (thumbs up, raised hands, magnifying glass, hammer and wrench, OK hand, traffic light), one per user per message. Tapping them lists who reacted.

Task chat messages can't be edited or forwarded. Code shared with group chats ([Chat conversation](https://docs.snapfix.com/how-the-apps-work/screens/chat/conversation.md)): the web task chat has its own components (`pages/task/task-chat/`) but uses the same `linkify` pipe and translation directive; iOS draws text, photo, video, voice and reply bubbles with the chat screen's cells (`TblCellChatText…`, `TblCellChatImage…`, `TblCellChatAudio…`, `TblCellChatReply…`) and the same transcript sheet (`TrascriptDataVC`), while documents, system lines and the reaction popup (`EmojiReactionVC`) are task-only; Android's task chat has its own adapter in `JobChatFragment` and its own reaction popup (`CustomReactionPopUp`).

## Inputs

| Field                   | Type                                                                 | Required                                                                                                     | Default                                      | Rules and messages                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Task name               | Text, several lines                                                  | Yes                                                                                                          | Current name                                 | Web and iOS: 255 characters; Android allows 2,000 though the database holds 255. Empty, or only spaces: web disables "Save" and says "Please enter a task name"; iOS says "Job name can't be blank."; Android ignores the change. Too long (web): "Your input exceeds the maximum allowed length of 255 characters". Unchanged: closes without saving.                                                                                                                                                                                                                                        |
| Notes                   | Text, several lines                                                  | No                                                                                                           | Current notes                                | 2,000 characters on all platforms; the web shows a counter ("0/2000"). Placeholder "Write a note here..." (web).                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Large text              | Text                                                                 | Yes, on large-text tasks                                                                                     | Current text                                 | Web: 50 characters; empty: "Please enter a text".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Status                  | Red, amber or green                                                  | -                                                                                                            | Red when created                             | See [Change status](#header-and-status).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Priority                | "1" ("High Priority") or "2" ("Medium Priority")                     | No                                                                                                           | None                                         | Choosing the set priority again clears it ("Priority cleared").                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Due date                | "Date:", "Time:", "Repeat reminder daily"                            | Date and time                                                                                                | Tomorrow 8:00 AM (web)                       | Web: today or later. Android ignores "Repeat reminder daily" when the due date is first set. The apps need a connection.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Reminder ("Remind me")  | Date, time, "Repeat reminder daily"                                  | Date and time                                                                                                | Tomorrow 8:00 AM (web)                       | Housekeeping tasks: only for users on today's housekeeping schedule ("You are not part of today's housekeeping schedule, or your role is not eligible to perform this task. As a result, you cannot set a reminder for it."). The apps need a connection.                                                                                                                                                                                                                                                                                                                                     |
| Time range              | "Start time" (24-hour), duration in hours and minutes                | Both                                                                                                         | Now                                          | Hours 0 to 168, minutes 0 to 59; at 168 hours the minutes are fixed at 0. Android: "Please select start time and duration".                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Time entry              | "NOTE", "HRS", "MIN", currency, "COST"                               | Note (web and iOS; Android not confirmed)                                                                    | Site's default currency; hours and minutes 0 | Hours, minutes and cost may be left as they are. Note up to 50 characters; hours 0 to 999; minutes 0 to 59; cost up to 10 digits and 2 decimals. No new row while another new row is incomplete ("Please fill all the details for the current time before adding a new one"). Invalid rows: "There's an issue with one of the fields. Please check the highlighted fields for more details".                                                                                                                                                                                                  |
| Cost entry              | "NOTE", currency, "COST"                                             | Note (web and iOS; Android not confirmed)                                                                    | Site's default currency                      | As time entries; the cost may be left empty.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Assigned users          | Users of the group, several                                          | No                                                                                                           | Current                                      | Housekeeping tasks list only users on today's housekeeping schedule, plus current assignees; iOS needs a connection to assign them.                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Followers               | Users of the group, several                                          | No                                                                                                           | Current                                      | The creator always follows and can't be removed (web).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Tags                    | Tags of one tag folder (web) or of all folders (apps), several       | No                                                                                                           | Current                                      | Searchable.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Room, area              | One room, one area                                                   | No                                                                                                           | Current                                      | A new choice replaces the current one.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Assets                  | Assets from any asset register, several                              | No                                                                                                           | Current                                      | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Compliance system       | One system, chosen by system type                                    | No                                                                                                           | Current                                      | A new choice replaces the current one.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Signature               | Drawing                                                              | To submit                                                                                                    | -                                            | Blocked while mandatory checklist items are open: "Signature can't be added" / "This checklist has mandatory items that are not yet checked. Complete them before adding your signature."                                                                                                                                                                                                                                                                                                                                                                                                     |
| Rejection note          | Text                                                                 | Web: yes ("Reject Task" stays disabled); apps: only for inspection tasks ("Please enter a note." on Android) | Empty                                        | Placeholder "e.g. The door is still broken" (web).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Share link lifetime     | One of a list                                                        | Yes                                                                                                          | Web: 1 month                                 | Web: 1 day, week, month or year. Apps: 1 day, week or month. Links made elsewhere: [Shared task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/shared-task.md#where-links-come-from).                                                                                                                                                                                                                                                                                                                                                                                              |
| Snooze reason and note  | "DND - Do Not Disturb", "NSR - No Service Required" or "Other"; text | Reason                                                                                                       | "Select a reason"                            | The note is optional ("Add a Note (optional)", hint "e.g. guest inside, maintenance issue, room locked..." on Android). The reason is saved as the label in the user's language.                                                                                                                                                                                                                                                                                                                                                                                                              |
| Housekeeping start time | Time in 5-minute steps                                               | Yes                                                                                                          | Current start                                | iOS offers only later times today ("This time has already passed. You can only move the task to a later slot on today's schedule."); Android accepts any time. Needs a connection.                                                                                                                                                                                                                                                                                                                                                                                                            |
| Chat message            | Text                                                                 | Yes, to send                                                                                                 | Empty                                        | Web: 5,000 characters; Enter sends, Shift+Enter adds a line. iOS: 10,000 characters. Android: any length, but text over 5,000 characters is cut to 5,000 plus "..." when sent.                                                                                                                                                                                                                                                                                                                                                                                                                |
| Attachments             | Files                                                                | -                                                                                                            | -                                            | Web: up to 30 per upload; images 20 MB, videos 40 MB; without "Access Attachments" only images and videos; when the group blocks gallery photos, no images or videos ("Update image or video from gallery not allowed"). iOS: documents 40 MB ("This file exceeds the maximum allowable size of 40 MB. Please choose a file that is less than 40 MB in size."). Android: videos and documents 40 MB ("Snapfix allows video size up to 40 MB. Please choose video up to 40 MB", "This file exceeds the maximum allowable size of 40Mb. Please choose a file that is less than 40Mb in size."). |
| Voice note              | Recording                                                            | -                                                                                                            | -                                            | Apps only, up to 10 minutes. A short tap shows "Hold to record, release to add".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Duplicate start date    | Date                                                                 | Yes                                                                                                          | Today                                        | Apps only, today or later.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## Actions

The web sends each field change as [`PUT /v1/app/tasks/{uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#put-v1apptasksuuid) with an `action` naming the field. The apps save changes on the device and the sync service sends them later ([States](#states), offline).

### Header and status

| Action                             | Who                                   | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Change status                      | Editable, with the color's permission | Without the permission: "You don't have the necessary permissions" (web), "You don’t have the right permissions to change task status in this group. Reach out to the group admin to review your permissions." (apps). Locked or archived (web): "Task is locked" or "Task is archived", in an "Alert" dialog. When the group blocks green until the checklist is complete: "All Checklist-items must be checked before you can move this Task to green. This condition was set by the Admin of this group." (web), "Checklist must be 100% before set to Green." (iOS), "Checklist must be 100% before set to Green" (Android). Free or churned sites over the free limit: web and Android refuse and show [Subscription limit](#subscription-limit); iOS has this check switched off \[[ASK-20](https://github.com/snapfix/docs/blob/main/ASK.md#ask-20-should-ios-enforce-the-free-plan-limit-on-status-changes)]. A status line goes into the chat; the web plays a short animation on green. If the task needs approval, a non-admin's green sends it for approval ("Sent for Approval") and a group admin's green approves it, adding the status line and "Task Approved" at once. An inspection task turned green also approves itself and its cleaning task when both have assignees. | Web: `action=color`, and [`GET /v1/app/parents/{uuid}/can-change-status`](https://docs.snapfix.com/engineering-reference/api/console.md) for the free limit. Apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job), [`?action=save_job_status_log`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_job_status_log), [`?action=save_pri_job_chat`](https://docs.snapfix.com/engineering-reference/api/chat.md) |
| Correct a drifted status           | Nobody chooses it                     | When the task's status differs from the last status line in its chat, the web changes the status to match as soon as the chat loads, under the viewer's account. The apps do the same after downloading the task again, and also correct the priority from the last priority line \[[ASK-19](https://github.com/snapfix/docs/blob/main/ASK.md#ask-19-should-opening-a-task-correct-its-status-from-the-chat)].                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Web: `action=color`. Apps: [`GET /v4/{user_uuid}/job/{job_uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-v4user_uuidjobjob_uuid), then the offline queue                                                                                                                                                                                                                                                                                                                        |
| Change priority                    | Editable                              | The star opens [Priority](#priority); when a priority is set, tapping it clears it. Toast "High Priority set", "Medium Priority set" or "Priority cleared" (web).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Web: `action=priority`; apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)                                                                                                                                                                                                                                                                                                                                                              |
| Rename                             | Editable                              | Opens [Task name](#task-name).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Web: `action=title`; apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)                                                                                                                                                                                                                                                                                                                                                                 |
| Set, change or remove the due date | Editable                              | Opens [Set due date](#set-due-date). Toast "Task Due Date Set.", "Task Due Date Updated." or "Task Due Date Unset." (iOS).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | All platforms: [`POST`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksuuiddue-date), [`PUT`](https://docs.snapfix.com/engineering-reference/api/tasks.md#put-v1apptasksuuiddue-date) or [`DELETE /v1/app/tasks/{uuid}/due-date`](https://docs.snapfix.com/engineering-reference/api/tasks.md#delete-v1apptasksuuiddue-date)                                                                                                                                                 |
| Previous, Next                     | Anyone                                | Opens the neighboring task of the list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Web: [`GET /v1/app/tasks/{uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-v1apptasksuuid)                                                                                                                                                                                                                                                                                                                                                                                        |
| Group name                         | Anyone (web)                          | Opens the group's details.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | [`GET /v1/app/businesses/{uuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md)                                                                                                                                                                                                                                                                                                                                                                                                          |
| Share                              | Anyone                                | Opens [Share task](#share-task); in the apps it's the first item of the task menu ("Share Task Report"), which Android hides outside the time range.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | See the dialog                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

### Task menu

Web "Actions"; iOS and Android: the three-dot menu, where most items sit under "Advanced Actions". When the task isn't editable the apps keep only what still applies, such as "Task Activity", "Unarchive", "Unlock" and "Delete" for those allowed. Outside the time range, iOS shows non-admins only "Task Activity" and group admins "Create Planned Tasks", "Task Activity" and "Delete"; Android shows "Delete" and "Task Activity" to everyone.

| Action                                                          | Who                                                    | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | API                                                                                                                                                                                                                                              |
| --------------------------------------------------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| "Create Planned Task" (web), "Create Planned Tasks" (apps)      | "Create Planned Tasks" and "Create New Task", editable | Opens [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md) prefilled from this task (web `/plan/planned-task/create/task/:id`). iOS needs a connection.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                                                                                                                                                                                                                                |
| "Copy Task to Group", "Move Task to Group"                      | Group admins, editable                                 | Opens [Copy or move task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/copy-move.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | See that screen                                                                                                                                                                                                                                  |
| "Duplicate Task (All messages)", "Duplicate Task (No messages)" | "Create New Task", editable                            | Web: confirm, then the copy is made in the same group at once ("Makes a copy of this Task in this Group, and includes all photos and messages, with the assigned users and tags." or "…includes only the initial photo/image, with the assigned users and tags."). The copy is named "Leaking tap Copy"; the page stays on the original. Apps: confirm ("Make a full copy of this task with all photos, messages, tags, and assigned users?" or "Make a partial copy of this task with just the first photo, tags, and assigned users?"), then pick the copy's start date. Today copies on the device; a later date asks the server to create the copy on that day ("Copy of this task will be created on your selected date."; failure: "Failed to create the copy Task. Please try again in a few minutes."). Android takes "today" for a later date in time zones behind UTC. | Web: [`POST /v1/app/tasks/copy`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskscopy); apps, later date: [`?action=copy_job_v2`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actioncopy_job_v2) |
| "Require Task Approval"                                         | Group admins, editable                                 | A switch (web menu; apps "+" menu), with "When enabled, this task must be approved by a Group Admin when changed to Green by a user. Admins are notified and can review approvals using the 'Approval tasks only' SnapFilter." Turning it off approves a task waiting for approval (API). On Android a task without its own setting shows the group's setting.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Web: `action=approvalRequired`; apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)                                                                                              |
| "Lock", "Unlock"                                                | See [Who can do what](#who-can-do-what)                | No confirmation. A locked task can't be changed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Web: `action=lock`; apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)                                                                                                          |
| "Archive", "Unarchive"                                          | See [Who can do what](#who-can-do-what)                | No confirmation. Archiving in the apps closes the screen; the web page stays, read-only. Archiving or unarchiving a cleaning task does the same to its inspection task.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Web: `action=archive`; apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)                                                                                                       |
| "Delete"                                                        | See [Who can do what](#who-can-do-what)                | Opens [Delete task](#delete-task). Deleting a cleaning task also deletes its inspection task. Then the screen goes back to the list (web after 1.5 seconds).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Web: [`DELETE /v1/app/tasks/{uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#delete-v1apptasksuuid); apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)     |
| "Task Activity"                                                 | Anyone (apps)                                          | Opens [Task activity](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-activity.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                                                                                                                                                                                                |

### Image, notes and location

| Action                      | Who                                                    | What happens                                                                                                                                                                                                                                                                                                                                                                       | API                                                                                                                                                       |
| --------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the image              | Anyone                                                 | Web: [Task image](#task-image). Apps: the [Gallery](https://docs.snapfix.com/how-the-apps-work/screens/tasks/gallery.md).                                                                                                                                                                                                                                                          | -                                                                                                                                                         |
| Change the image            | See [Who can do what](#who-can-do-what)                | Web: "Upload image" in [Task image](#task-image). Apps: "Change Image" in the image menu.                                                                                                                                                                                                                                                                                          | Web: `action=image`; apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job) after the upload |
| Edit the large text         | Editable                                               | Web: the pencil opens [Large text](#large-text).                                                                                                                                                                                                                                                                                                                                   | Web: `action=largeTitle`                                                                                                                                  |
| Download or share the image | Anyone                                                 | Apps: "Download" and "Share" in the image menu. Web: "Download" in [Task image](#task-image).                                                                                                                                                                                                                                                                                      | -                                                                                                                                                         |
| Edit notes                  | Editable; the web lets read-only members edit them too | Web: edit inline, "Save" or "Cancel"; "Show More" / "Show less" for long notes. Apps: [Notes](#notes). A cleaning task's notes also go to its inspection task (API).                                                                                                                                                                                                               | Web: `action=description`; apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)            |
| Show the location           | Anyone                                                 | Web: the map button opens [Task location](#task-location). Apps: "Map". Without a location, iOS asks editors "There is no location specified for this task. Do you want to manually specify a location by clicking on a map?" and others get the reason, such as "There is no location specified for this task. Due to your task is locked you can't set task location right now." | Apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)                                       |

### Users, tags, rooms, assets and compliance

| Action                                       | Who                                            | What happens                                                                                                                                                                                                                                                                                                                                                                                           | API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Assign users                                 | Editable, "Assign Users"                       | Opens [Assigned to, Followed by](#assigned-to-followed-by). Assigning a contractor also emails them a link to the task.                                                                                                                                                                                                                                                                                | Web: [`POST /v1/app/tasks/assign/multi`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksassignmulti), [`POST /v1/app/tasks/notify-contractor`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksnotify-contractor); apps: [`?action=save_pri_job_userassigned`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job_userassigned)                                                                                                                                                                                                                                                                                |
| Follow ("Follow Task" in the apps' "+" menu) | Editable, "Assign Users"                       | Opens "Followed by".                                                                                                                                                                                                                                                                                                                                                                                   | Web: [`POST /v1/app/tasks/follow/multi`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksfollowmulti); apps: [`?action=save_pri_job_user`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job_user)                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Tag                                          | Editable                                       | Web: a tag folder's pencil, or the folder in the quick-action menu, opens [Tags](#tags) for that folder. Apps: the tag button opens the tagging sheet.                                                                                                                                                                                                                                                 | Web: [`POST /v1/app/tasks/tag/multi`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskstagmulti); apps: [`?action=save_pri_job_tag`](https://docs.snapfix.com/engineering-reference/api/tags.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Set or change the room or area               | Editable                                       | Opens [Rooms and areas](#rooms-and-areas).                                                                                                                                                                                                                                                                                                                                                             | Web: [`POST /v1/app/tasks/room-add`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksroom-add), [`room-remove`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksroom-remove), [`area-add`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksarea-add), [`area-remove`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksarea-remove); apps: [`?action=save_pri_job_room`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job_room), [`?action=save_pri_job_area`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job_area) |
| Remove the room or area                      | Editable                                       | Web: confirm "Remove Task from Room" / "Are you sure you want to remove this task from Room …?", or the same for an area. The web pastes the room or area name into the dialog unescaped. When the page was opened from that room or area, it goes back to its task list.                                                                                                                              | As above                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Link or unlink assets                        | Editable (iOS: unlinking by group admins only) | Web: [Assets](#assets). Apps: [Select asset register](https://docs.snapfix.com/how-the-apps-work/screens/assets/select-asset.md). Tapping a linked asset opens [Asset detail](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-detail.md), or says "You don't have permission to view this asset" (web). iOS needs assets in the site's plan ("Not included in this business account"). | Web: [`POST /v1/app/tasks/asset-link`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksasset-link), [`POST /v1/app/tasks/asset-unlink`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksasset-unlink); apps: [`?action=save_pri_jobjoblink`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_jobjoblink), as a link between the task and the asset                                                                                                                                                                                                                                                               |
| Set or remove the compliance system          | Editable                                       | Web: [Compliance system](#compliance-system); remove with "Remove Task from System" / "Are you sure you want to remove this task from System …?", with the system name pasted in unescaped. Apps: the tagging sheet.                                                                                                                                                                                   | Web: [`POST /v1/app/tasks/system-add`](https://docs.snapfix.com/engineering-reference/api/compliance.md), [`POST /v1/app/tasks/system-remove`](https://docs.snapfix.com/engineering-reference/api/compliance.md); apps: [`?action=save_job_comply_system`](https://docs.snapfix.com/engineering-reference/api/compliance.md)                                                                                                                                                                                                                                                                                                                                                                           |
| Open the parent task                         | Anyone                                         | An inspection task's cleaning task opens; on the web only for members of its group ("You're not a member of this group.").                                                                                                                                                                                                                                                                             | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Snapfix AI suggestions                       | Automatic (web)                                | Right after a task is created with Snapfix AI on, the page asks for suggested rooms, areas and tags, and for suggested assignees only when the creator's "Enable AI Auto-Assign" switch is on for the site ([Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md#site-permissions-web)), as iOS and Android do too, and applies them; suggested values carry an AI badge.       | [`/v1/app/tasks/suggestions/…`](https://docs.snapfix.com/engineering-reference/api/ai.md), then the endpoints above                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

### Checklist, time range, time and cost, reminder

| Action                              | Who          | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Add a checklist                     | Editable     | Web: "+" on "Checklist" opens the add-checklist dialog; without the site's checklist setting: "You either don’t have permission to add a new checklist template or no folder is enabled. Please contact your site administrator for assistance." Apps: "Add Checklist". See [Checklist](#checklist).                                                                                                                                                                             | [Checklists API](https://docs.snapfix.com/engineering-reference/api/checklists.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Open the checklist                  | Editable     | Opens [Checklist](https://docs.snapfix.com/how-the-apps-work/screens/checklists/checklist.md).                                                                                                                                                                                                                                                                                                                                                                                   | [Checklists API](https://docs.snapfix.com/engineering-reference/api/checklists.md); [`PUT /v1/app/tasks/{uuid}/todo-name`](https://docs.snapfix.com/engineering-reference/api/tasks.md#put-v1apptasksuuidtodo-name), [`PUT /v1/app/tasks/{uuid}/signature`](https://docs.snapfix.com/engineering-reference/api/tasks.md#put-v1apptasksuuidsignature)                                                                                                                                                                                                                       |
| Checklist menu                      | Editable     | Web: "View Checklist"; "Edit" (site admins, or checklists not made from a template) opens [Edit checklist](https://docs.snapfix.com/how-the-apps-work/screens/checklists/edit-checklist.md); "Clear Checklist" (confirm "Are you sure you want to clear all checklist items?"); "Set as template" (site admins, not for template checklists); "Remove From Task" (confirm "Remove Checklist" / "Removing this checklist cannot be undone. Do you want to continue ?", "Remove"). | [Checklists API](https://docs.snapfix.com/engineering-reference/api/checklists.md); clearing uses [`GET /v1/app/todos/reset`](https://docs.snapfix.com/engineering-reference/api/checklists.md)                                                                                                                                                                                                                                                                                                                                                                            |
| Sign off                            | Editable     | Web: "Sign off checklist", draw, "Submit" ("Clear", "Close"). The box then shows "Checklist signed off" with the signature. The box is marked disabled exactly when the user may sign. Clearing a signed checklist resets the signature.                                                                                                                                                                                                                                         | [`POST /v1/app/tasks/{uuid}/signature`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksuuidsignature); reset [`?action=webcust_reset_job_signature`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionwebcust_reset_job_signature)                                                                                                                                                                                                                                                                                       |
| Set, change or reset the time range | Group admins | Web: "+" or the pencil on "Time Range" opens [Set Time Range](#set-time-range). Apps: "Set Time Range" or "Update Time Range" in the "+" menu; an assigned housekeeper gets [Housekeeping schedule](#housekeeping-schedule) instead. Others on Android: "A Time Range has been set for this task, allowing it to be updated between the Start and End times. Please contact your Admin, who can change the Time Range to allow an update to this task."                          | Web: [`POST /v1/app/tasks/{uuid}/time-range`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksuuidtime-range), reset [`DELETE /v1/app/tasks/{uuid}/time-range`](https://docs.snapfix.com/engineering-reference/api/tasks.md#delete-v1apptasksuuidtime-range); apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)                                                                                                                                                               |
| Add or edit time, cost              | Editable     | Web: "+" or the pencil on "Cost" or "Time". Apps: "Add Time" / "Edit Time", "Add Cost" / "Edit Cost" in the "+" menu, greyed out on iOS when the site's plan lacks them. Opens [Time and cost](#time-and-cost).                                                                                                                                                                                                                                                                  | Web: [`POST /v1/app/tasks/job-time/multi`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksjob-timemulti), [`POST /v1/app/tasks/job-cost/multi`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksjob-costmulti); apps: [`?action=save_pri_job_timecost`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job_timecost)                                                                                                                                                               |
| "Download Statement Of Fees"        | Anyone (web) | Builds a time and cost PDF and downloads it.                                                                                                                                                                                                                                                                                                                                                                                                                                     | [`?action=job_tc_report`](https://docs.snapfix.com/engineering-reference/api/reports.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Set, change or cancel "Remind me"   | Editable     | Opens [Remind me](#remind-me). Setting a reminder also assigns the user to the task. The "Reminder" card reads "Assigned users will receive a reminder for the task on … at …." The web then notifies the group's admins, users with "View All Tasks", assignees, followers and the creator.                                                                                                                                                                                     | [`GET`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-job-reminderjob_uuid), [`POST`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminderjob_uuid) or [`DELETE /job-reminder/{job_uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#delete-job-reminderjob_uuid); web also [`POST /v1/app/tasks/assign/multi`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksassignmulti) and [`POST /req-to-notify-user`](https://docs.snapfix.com/engineering-reference/api/notifications.md) |

Android also has a sheet for a daily reminder to the assigned users (`AddUpdateDailyReminderBottomSheet`), but its menu item is always hidden, so it can't be opened from this screen \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)].

### Approval and housekeeping

| Action                | Who                                                       | What happens                                                                                                                                                                                                                                                                                                                                                                                            | API                                                                                                                                               |
| --------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Approve               | See [Who can do what](#who-can-do-what)                   | The task stays green and becomes approved ("Task approved successfully."); an inspection task also turns green and approves its cleaning task.                                                                                                                                                                                                                                                          | Web: `action=approvalStatus`; apps: [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job) |
| Reject                | Same                                                      | Opens [Approval Request (reject)](#approval-request-reject). The task goes back to red ("Task rejected."), with "Task Rejected" and the note in the chat. Rejecting an inspection task rejects its cleaning task and keeps the inspection task green; every platform also creates the follow-up housekeeping tasks.                                                                                     | As above; inspection tasks also [`POST /v1/app/housekeeping/reject-tasks`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md)    |
| "Snooze"              | Editable housekeeping tasks that aren't green (apps only) | Opens [Snooze Task](#snooze-task), then adds the snooze line to the chat ("Task is snoozed."). "NSR - No Service Required" archives the task and its linked task. Otherwise the task turns red (iOS: for every reason); iOS asks housekeeping to reassign it when it has an assignee, and Android moves a time range one hour later and, with an assignee, asks housekeeping to rearrange the timeline. | The offline queue; [housekeeping reassignment](https://docs.snapfix.com/engineering-reference/api/housekeeping.md)                                |
| Housekeeping schedule | Assigned housekeepers on housekeeping tasks (apps only)   | "Set Time Range" / "Update Time Range" opens [Housekeeping schedule](#housekeeping-schedule).                                                                                                                                                                                                                                                                                                           | [`POST /v1/app/housekeeping/reassignment/{uuid}`](https://docs.snapfix.com/engineering-reference/api/housekeeping.md)                             |
| "NFC Scan"            | Editable (iOS, devices with NFC)                          | Reads an NFC tag and updates the checklist item that matches it. Needs NFC in the site's plan ("Not included in this business account").                                                                                                                                                                                                                                                                | The offline queue                                                                                                                                 |

### Chat actions

| Action                              | Who                                                 | What happens                                                                                                                                                                                                                        | API                                                                                                                                                                                                                             |
| ----------------------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Send a message                      | Editable                                            | Shown at once; on the web a failed message offers "Resend". With a reply open, the message quotes it. The web's send button has the tooltip "Attachment".                                                                           | Web: [`POST /v1/app/chat`](https://docs.snapfix.com/engineering-reference/api/chat.md); apps: [`?action=save_pri_job_chat`](https://docs.snapfix.com/engineering-reference/api/chat.md) plus a live update                      |
| Reply                               | Editable                                            | Web: "Reply" in the message menu. iOS: swipe the message; both apps: reply in the long-press menu. A preview with a remove button sits above the composer.                                                                          | As above                                                                                                                                                                                                                        |
| Attach photos or videos             | Editable, and the group allows gallery photos (web) | Web: "+" then "Image" opens [Upload](#upload). Apps: the camera button or "Add Photo, Video, Sketch or Signature" opens the camera.                                                                                                 | Web: [`POST /v1/app/chat/file`](https://docs.snapfix.com/engineering-reference/api/chat.md); apps: uploaded by the sync service, then [`?action=save_pri_job_chat`](https://docs.snapfix.com/engineering-reference/api/chat.md) |
| Attach documents                    | Editable, "Access Attachments"                      | Web: "+" then "Attachment". Apps: "Attach Document".                                                                                                                                                                                | As above                                                                                                                                                                                                                        |
| Record a voice note                 | Editable (apps only)                                | Hold the microphone, slide to cancel ("Slide To Cancel" on iOS), release to send.                                                                                                                                                   | As above                                                                                                                                                                                                                        |
| React                               | Editable                                            | Web: the emoji button on a message. Apps: long press. Choosing your emoji again removes it; choosing another replaces it.                                                                                                           | Web: [`POST /v1/app/chat/reaction`](https://docs.snapfix.com/engineering-reference/api/chat.md); apps: [`?action=save_pri_log_reaction`](https://docs.snapfix.com/engineering-reference/api/chat.md)                            |
| See reactions                       | Anyone                                              | Tapping a message's reactions opens [Reactions list](#reactions-list). Tapping your own row ("Tap to remove") removes your reaction; on the web this can remove the wrong one or fail when someone else added the same emoji later. | As above                                                                                                                                                                                                                        |
| Copy                                | Editable                                            | Text: "Copy Message" ("Message copied to clipboard"). Documents (web): "Copy" copies the link ("The link to this document has been copied to clipboard").                                                                           | -                                                                                                                                                                                                                               |
| Delete a message                    | See [Who can do what](#who-can-do-what)             | Opens [Delete message](#delete-message). The message disappears for everyone.                                                                                                                                                       | Web: [`DELETE /v1/app/chat/{uuid}`](https://docs.snapfix.com/engineering-reference/api/chat.md); apps: [`?action=save_pri_job_chat`](https://docs.snapfix.com/engineering-reference/api/chat.md)                                |
| Create a task from a photo or video | Web: "Create New Task"                              | Web: "Create Task" in the message menu opens [Add a Task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md) with the media. Apps: the "+" on the media. Starts a new task from the media.                       | See [Add a Task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md)                                                                                                                                          |
| Download or share media             | Anyone (apps)                                       | "Download" saves it to the phone; "Share" opens the system share sheet.                                                                                                                                                             | -                                                                                                                                                                                                                               |
| Open a document, play a voice note  | Anyone; documents need "Access Attachments"         | Documents open in a new tab (web) or a viewer (apps).                                                                                                                                                                               | -                                                                                                                                                                                                                               |
| See the transcript                  | Anyone (apps)                                       | Opens [Voice transcript](#voice-transcript).                                                                                                                                                                                        | -                                                                                                                                                                                                                               |
| Load older messages                 | Anyone (web)                                        | Scrolling up loads the next 20.                                                                                                                                                                                                     | [`POST /v1/app/chat/list`](https://docs.snapfix.com/engineering-reference/api/chat.md)                                                                                                                                          |

### When the screen opens

* **Web** loads the task and its group, room or area, then the chat and the checklist ([`GET /v1/app/tasks/{uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-v1apptasksuuid), [`GET /v1/app/businesses/{uuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md), [`POST /v1/app/chat/list`](https://docs.snapfix.com/engineering-reference/api/chat.md), [`GET /v1/app/todos`](https://docs.snapfix.com/engineering-reference/api/checklists.md)). Every 15 seconds, while the browser tab is visible and no checklist is being edited, it asks whether the task changed and reloads it quietly if so ([`POST /v1/app/tasks/get-updates`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksget-updates)). If the task belongs to another site than the one selected, the page switches site; switching site while on the page goes to `/fix`. A Survicate survey may show (`WebTaskScreen`).
* **The API** marks the task and its group as viewed. The apps also log the view when the user leaves ([`?action=save_pri_log_jobvieweduser`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_log_jobvieweduser)).
* **iOS and Android** show the task from the device's database at once, and download it again when the device copy looks out of date ([`GET /v4/{user_uuid}/job/{job_uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-v4user_uuidjobjob_uuid)). Changes by other people (messages, status, deletion, access changes) arrive as live updates through Firebase.

## States

* **Loading:** web shows a skeleton until the task arrives, then fills each section as its data loads; the chat shows a loading animation. The apps show the device copy at once.
* **Empty:** a new task's chat holds only the "task created" card. Empty sections on the web offer "+" to people who can add (checklist, assets, rooms and areas, compliance, time range, time and cost, reminder).
* **Error:** web shows the API's message, or "Internal server error", in an alert ([shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md)). If the task can't be loaded, the page goes back to the list. iOS goes back when downloading the task fails.
* **No permission:** the API answers "Access denied" and the web goes back to the list. Read-only users see the task, but the controls are hidden or refuse, and the composer is hidden.
* **Locked:** fields can't be changed; the web hides the quick actions and the edit pencils, and all platforms hide the composer. The web menu keeps only "Unlock" and "Delete", for those allowed.
* **Archived:** as locked; the web menu keeps only "Unarchive" and "Delete".
* **Outside the time range:** as locked. The web opens an alert: "A Time Range has been set for this task, allowing it to update between … and … times." with "Please change the Time Range to allow an update to this task." (group admins) or "Please contact your Admin, who can change the Time Range to allow an update to this task." (others); not for housekeeping tasks.
* **Ahead of its day (apps):** a planned task created before its day is read-only.
* **Waiting for approval:** the task is green with a pending approval; reviewers see the approval card.
* **Soft-frozen (web):** opening a frozen task shows "Loading task" / "This task has not been updated in a while. We now need to retrieve it so that you can update it." for three seconds and unfreezes it ([`POST /v1/app/tasks/soft-freeze`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskssoft-freeze)) \[[ASK-7](https://github.com/snapfix/docs/blob/main/ASK.md#ask-7-should-soft-freeze-still-run)].
* **Deleted:** after deleting, the screen goes back to the list. When someone else deletes the task while it's open, iOS and Android close the screen.
* **Offline (apps):** most changes are saved on the device and sent by the sync service when online, through php-apis actions that trust the user named in the request. Server-only actions refuse: due date and reminder ("We have detected that you are offline. Please reconnect to use all the features of Snapfix." on iOS), sharing, the report, a duplicate for a later date, planned tasks (iOS), the housekeeping schedule, and assigning users to housekeeping tasks (iOS) ("You must be connected to the Internet to carry out this task. Please connect and try again."). Details in [shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md).

## Dialogs and sheets

### Task name

Web "Edit task name" ("Task name \*", a counter such as "19 / 255", "Cancel", "Save"); iOS `EditTaskNameVC` ("Task title"); Android `TaskTitleBottomSheet` ("Task name", "Cancel", "Update"). Rules under [Inputs](#inputs).

### Notes

Web: inline in the "Notes" card. iOS `AlertNoteVC`; Android `AddUpdateNotesBottomSheet` ("Note", "Cancel", "Save").

### Large text

Web "Update text" (`TaskLargeTitleDialogComponent`): the text and "Save".

### Task image

Web "Task Image" (`TaskImageDialogComponent`): the photo or large text, "Copy" (copies the image link, "URL copied to clipboard", or the large text, "Copied to clipboard"), "Upload image" (opens [Upload](#upload)) and "Download". The apps use the [Gallery](https://docs.snapfix.com/how-the-apps-work/screens/tasks/gallery.md) and the image menu instead.

![Task image](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-90dad094dbabbd274922ef26d0212357519482bf%2Ftask-image.jpg?alt=media)

### Task location

Web "Task location" (`TaskLocationDialogComponent`): a map with the task's pin and a street view, view only.

### Priority

Web "Priority" (`TaskPriorityDialogComponent`): "Please choose a priority:" with the stars "1" and "2", without labels; choosing one applies it at once, and there is no OK button. Android `TaskPriorityBottomSheet`; iOS the priority control.

### Set due date

Web `TaskDueDateDialogComponent` and Android `DueDateBottomSheet`, both titled "Set due date", and iOS `SetDueDateVC`. Fields "Date:", "Time:" and "Repeat reminder daily". Buttons "Cancel" (no due date yet) or "Cancel due date" (removes it), and "Ok" (shown as "OK" on the web). The web saves even when nothing changed.

### Remind me

Web `TaskReminderDialogComponent` and Android `RemindMeBottomSheet`, both titled "Remind me", and iOS `RemindMeVC`. On the web, the info button in the title explains "By setting a Reminder, you will also be assigned to the Task (if you are not already assigned)." Fields "Date:" ("Start Date:" when repeating), "Time:" and "Repeat reminder daily". Web buttons: "Cancel" or "Cancel Reminder", and "Apply" or "Update"; Android: "Cancel reminder" and "Set". The web saves even when nothing changed, and then notifies people again.

### Assigned to, Followed by

Web `TaskUsersDialogComponent`, titled "Assigned to" or "Followed by", with "Assign Users: Select users and click "Save" to make them accountable for the task. The assigned user can instantly see their tasks. Assigning also improves dashboards and reports." or "Follow Task: Following a task is an efficient way to track its progress, especially when you are not assigned to it or responsible to get it done. Very useful for accurate dashboard and reports too." A searchable list of the group's users with checkboxes, "Cancel" and "Save". iOS `PopupUserChat`, Android `AssignUserBottomSheet`.

### Tags

Web `TaskTagsDialogComponent`, titled with the tag folder's name: "Search", the folder's tags with checkboxes ("New tag created by AI" on tags the AI added), "No data available" when empty, "Cancel" and "Save". The apps use one tagging sheet for tags, room, area, assets and compliance (iOS `TaggingMainVC`, Android `TaskTaggingBottomSheet`).

### Rooms and areas

Web `TaskRoomsAndAreasDialogComponent`: "Tag a Room", "Tag an Area" or "Tag an Area and/or a Room", with "Select the Room where the task is located." or "Select the Area to indicate where this task is located." and an info popover ("Tagging a Task to a Room will help your team to be more efficient."). Tabs for rooms and areas with counts, one choice each, and "Save". The apps use the tagging sheet.

### Assets

Web `TaskAssetsDialogComponent` "Assets": the site's asset registers, each with checkboxes for its assets; "No data available" without registers; "Cancel" and "Save". The apps use [Select asset register](https://docs.snapfix.com/how-the-apps-work/screens/assets/select-asset.md).

### Compliance system

Web: "Select a System Type" (`SystemTypeDialogComponent`), then "Select a System" (`SystemDialogComponent`), each with "Cancel" and "SELECT". See [Compliance systems](https://docs.snapfix.com/product/features/compliance/compliance-systems.md). The apps use the tagging sheet.

### Set Time Range

Web `TimeRangeDialogComponent`, iOS `SetTimeRangeVC`, Android `TimeRangeBottomSheet`. Text: "This task can be updated only within this time range.", "Set the start time and the duration. The start time relates to the day that the Task is planned." and "Max duration is 168 hours (7 days) that the Task is planned." Fields "Start time" and "Duration"; "End time" appears once both are set. Buttons "Cancel" (no range yet) or "Reset" (removes it), and "Save".

### Housekeeping schedule

For an assigned housekeeper on a housekeeping task, in place of the time range. iOS `HousekeepingScheduleHostingController` ("Schedule", "Start time", "Cancel", "Save"); Android `HkTaskScheduleBottomSheet` with a 5-minute time picker. Saving moves the task on today's [timeline](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md); Android confirms "Changes have been saved" and asks "Please select start time" when none is picked. Both apps have it in their builds, so it isn't Android-only \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)].

### Time and cost

Web `TaskTimeCostDialogComponent`: "Add Time" / "Edit Time" or "Add Cost" / "Edit Cost". One row per entry with a delete button, "Add More Time" / "Add More Cost", "Cancel" and "Save". iOS `TaskTimeBottomSheetVC` and `TaskCostBottomSheetVC`; Android `AddTimeBottomSheet` and `AddCostBottomSheet`. Rules under [Inputs](#inputs).

### Share task

Web `TaskShareDialogComponent` "Share Task", "Select how you'd like to share this task.":

* "Task Report" ("The Task Report contains the task summary including tags, cost & time, checklist summary, images and the entire audit trail including messages.") starts the PDF and shows "The report is being generated." with a link to [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md) ([`?action=job_report_v2`](https://docs.snapfix.com/engineering-reference/api/reports.md)).
* "Task URL" ("The Task URL can be accessed by anyone who receives the link. The task is read-only and contains the image, notes and message stream.") opens "Share Task URL": "Select how long the Task URL will stay active.", "Expired Task URLs can not be accessed." and "Task URL access expires in:", the lifetimes (see [Inputs](#inputs)), "Back" (to the two choices) and "Generate Task URL". Then "Here is your url:" with the link, "Copy URL" ("URL copied to clipboard") and "Open in new Window"; this step has no "Back" ([`POST /v1/app/tasks/generate-url`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksgenerate-url)). The link opens [Shared task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/shared-task.md).

iOS `ShareTaskVC` and `ShareTaskURLVC`, Android `ShareTaskBottomSheet`: the same two choices, both needing a connection. The report is built at once and handed to the system share sheet ([`?action=get_job_report`](https://docs.snapfix.com/engineering-reference/api/reports.md)); tasks with more than 50 photos, videos and drawings or more than 100 checklist items get "This task is too large. Please generate the Task Report using the web app: …" instead ("Open WebApp" on iOS). The link goes to the system share sheet ([`?action=generate_task_url`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actiongenerate_task_url)).

### Copy or move to group

[Copy or move task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/copy-move.md).

### Duplicate

Web: an alert titled "Duplicate Task (All messages)" or "Duplicate Task (No messages)" with the matching description, "No" and "Yes". Apps: the confirmation, then a date picker limited to today and later (iOS `CopyTaskCalenderPopUpVC`, Android titled "Copy task").

### Delete task

Web "Delete Task": "Deleted tasks cannot be recovered. Do you want to delete this task?" (cleaning tasks: "Deleted tasks cannot be recovered and any linked tasks will also be deleted. Do you want to delete this task?"), "Cancel" and "Delete". On sites with AI translation on, the text can show stray `<\/div>`. iOS "Alert": "Deleted tasks can not be recovered. Do you want to delete this task?", "Yes" and "No"; for a cleaning task whose inspection task is already in progress or done, a second warning follows ("Some linked child tasks are already in progress or completed. Deleting this parent task will also delete those linked tasks. Do you want to continue?"). Android: the same question, with a cleaning-task variant.

### Approval Request (reject)

Web `TaskRejectDialogComponent` "Approval Request": "Note" (placeholder "e.g. The door is still broken") and "Reject Task". iOS `RejectAlertVC`, Android `RejectTaskApprovalBottomSheet`.

### Snooze Task

Apps only. iOS `SetSnoozeVC`, Android `SnoozeTaskBottomSheet` ("Snooze Task"): the reason ("Select a reason", then "DND - Do Not Disturb", "NSR - No Service Required" or "Other"), an optional note, "Cancel" and the save button ("Save & Snooze" on Android).

### IoT message

Apps only. iOS `ChipVC`, Android `IOTMoreDetailDialog`: the full sensor message, opened from "more" on a sensor message in the chat.

### Message menu

Web: on each message, an emoji button with the six reactions and, when the user has actions, a menu with "Reply", "Copy Message" (or "Copy" for documents), "Create Task" and "Delete Message". iOS `EmojiReactionVC`: a long press shows the emoji row and buttons for back, reply, copy, delete, download and share. Android: a long press shows the emoji row (`CustomReactionPopUp`) and, in the toolbar, back, reply, copy, delete, download and share. Which buttons appear is under [Chat actions](#chat-actions).

### Reactions list

Web: a menu with "All" and one filter per emoji, with counts, then the users ("You" and "Tap to remove" on your own row). iOS `EmojiReactionListVC`, Android `ReactionsBottomSheetDialogFragment`.

### Delete message

Web "Delete Message": "Are you sure you want to delete this message?". iOS: the same question with "Yes" and "No". Android "Delete Confirmation" with the same question. iOS also lets two staff accounts, named in the code, delete any message with a long press.

### Voice transcript

Apps only. iOS `TrascriptDataVC`, Android `TranscriptBottomSheet`: the voice note's text.

### Checklist

[Checklist](https://docs.snapfix.com/how-the-apps-work/screens/checklists/checklist.md) and [Edit checklist](https://docs.snapfix.com/how-the-apps-work/screens/checklists/edit-checklist.md). Adding one: web `TaskAddChecklistDialogComponent`, iOS `AddChecklistTemplate`, Android `AddChecklistBottomSheet`. The apps' checklist menu: iOS `CLTemplateOptionsVC`, Android `BottomSheetCheckListActionMenu`.

### Upload

Web `UploadFileDialogComponent`, titled "Upload image" or "Upload file", for chat attachments and the task image. Limits under [Inputs](#inputs).

### "+" menu (apps)

iOS `TaskOptionsBottomSheetVC`, Android `NewJobMenuBottomSheet`: "Add Photo, Video, Sketch or Signature", "Attach Document" ("Access Attachments"), then "Advanced Actions": "Add Time" / "Edit Time", "Add Cost" / "Edit Cost", "Set Time Range" / "Update Time Range" (group admins), "Add Checklist" / "Edit Checklist", "Follow Task" ("Assign Users"), "Require Task Approval" (group admins), "Attributes" (asset registers, see [Asset attributes](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-attributes.md)) and, on iOS, "NFC Scan". Items that need an editable task disappear when it isn't.

### Subscription limit

Web `AlertSubscriptionDialogComponent`: "You have reached the free limit of Tasks you can Snapfix (from Red to Yellow to Green).", "You can still continue to create new Tasks.", "We are delighted that you have been getting benefits, and we have a number of great value subscription options on the App Store and Website.", "Happy Snapfixing!" and the button "See subscriptions options", which opens <https://snapfix.com/pricing> in a new tab (web\_app\_v2 @ 0989b8e685, `src/app/components/alert-dialog/alert-subscription-dialog/alert-subscription-dialog.component.html:7-16`). Android `TaskLimitReachedDialog`, whose "See subscriptions options" opens <https://snapfix.com/sales> (android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/dialog/TaskLimitReachedDialog.kt:67-72`). iOS has none \[[ASK-20](https://github.com/snapfix/docs/blob/main/ASK.md#ask-20-should-ios-enforce-the-free-plan-limit-on-status-changes)].

### Other popups

* Web "Loading task" for soft-frozen tasks (see [States](#states)).
* iOS coach marks on the first visit (`IntroHelper`, `TaskInfoVC`), and the first-task popups (iOS `FirstTaskCreatedPopupVC`, Android `FirstTaskCompleteBottomSheet`).

## Platform differences

* **Layout:** the web shows everything at once in three columns, with the activity log on the page; the apps stack a scrolling header card above the chat and keep the activity log on its own screen.
* **Moving between tasks:** buttons on all platforms; neither app swipes.
* **Apps only:** recording voice notes, snoozing, the housekeeping schedule, sensor messages, duplicating for a later date, working offline; NFC scans on iOS.
* **Web only:** "Download Statement Of Fees", "Last viewed", resending a failed message, and correcting the status under the viewer's account as soon as the chat loads \[[ASK-19](https://github.com/snapfix/docs/blob/main/ASK.md#ask-19-should-opening-a-task-correct-its-status-from-the-chat)].
* **Permissions:** lock, archive, delete, asset removal and message deletion follow different rules per platform (see [Who can do what](#who-can-do-what)); rejection notes are required only on the web; the free-limit check is off on iOS \[[ASK-20](https://github.com/snapfix/docs/blob/main/ASK.md#ask-20-should-ios-enforce-the-free-plan-limit-on-status-changes)].
* **Limits:** task names, chat messages and attachments have different limits (see [Inputs](#inputs)).
* **Sharing:** the web also offers a one-year link, and builds the task report in the background for Task reports; the apps build it at once and share the PDF.


---

# 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/task-detail.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.
