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

# Shared task

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

A read-only page for a task or asset shared by link: its details, image, note, checklist, tags or attributes, users and chat, until the link expires.

* **Where:** task.snapfix.com `/:id` (web\_tasks), where `:id` is the link token. Links come from "Share" on a task or asset ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md)), from the email sent to a contractor assigned to a task, and from a QR form's confirmation page and email (see [Where links come from](#where-links-come-from)). Any other path, including `/`, shows "404", "Page not found", "The page you are looking for doesn't exist".
* **Who:** anyone with the link, without signing in. The page is the same for everyone; signed-in Snapfix users are not recognized.
* **Feature:** [Sharing tasks](https://docs.snapfix.com/product/features/tasks/task-sharing.md)

![Shared task](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-0878266f656909072ab5355e93aeac8a57a239c8%2Fshared-task.png?alt=media)

## Layout

The browser tab reads "Snapfix Public Task". From top to bottom:

1. **Header.** Left: "Access expires" and the link's expiry in the viewer's local time, as `12 Mar 14:30` in the current year and `12 Mar 2027 14:30` otherwise. Centre: the Snapfix logo. Right: "Log In"; on screens under 960 px wide it moves into a menu button.
2. **Task card**, full width: the group's image (or a default image), the group name, the site name, and the task title.
3. **Left column**:
   * **Image.** The task photo; or the task's large text, for tasks created on or after 2022-09-05 that have one; or a "no image" placeholder. The priority flag (filled when the task has a priority) and the status light sit in the top corner. Photos show small, at 200 px, instead of filling the block.
   * **"Note"**, when the task has a description.
   * **"Checklist : 40% complete"**, when the task has a checklist: one expanded row per item and section, in creation order. Each row shows a checkbox (ticked when done, disabled for sections), a Smart Tag icon when the item needs an NFC scan, the item name (emphasized when done), and "\*" when an answer is mandatory. Below the name: "Pass", "Flag" and "Fail" with the chosen one marked, when the item has them; and, when the item allows notes, its note and its photos and videos in a carousel of one to three thumbnails with back and next arrows and a counter such as "3/7". The percentage counts done items against all items that are not sections.
   * **Tags** (tasks): "# Tags", with one row per tag folder holding its tags as `#Lobby`.
   * **Attributes** (assets, instead of tags): one collapsed panel per attribute category, sorted by name; attributes without a category go under "Attributes", and "Tracking" gets a barcode icon. A panel lists the attributes that have a value: QR codes as a QR image, barcodes as a barcode with its number, Smart Tags with an icon and the tag ID, dates as `dd/MM/YYYY`, and the rest as text. Dates near New Year can show the wrong year. A panel without values says "No data available".
   * **"Users"**: "Created by", "Assigned to" and "Followed by", each with photos (or initials) and names. Empty lists show only their heading.
4. **Right column, "Messages"**: the task chat, grouped by day under "Today", `Nov 10` or `Nov 10 2025`, oldest first, scrolled to the newest. Each item has the author's photo or initials, its content, and "Jane Doe : 14.30" (the time it was last changed). Items by the author of the first item shown sit on one side, everyone else's on the other. The column is as tall as the left column and scrolls on its own.

On screens under 960 px wide the columns stack: the task card, the left column, then "Messages".

The chat shows:

* Text messages, with the message they reply to quoted above them, or "Message could not be found" when the original isn't in the list.
* Photos and sketches, videos with player controls, voice messages with an audio player, and documents with a file-type icon and the file name.
* Activity lines: "changed Task Image" with the new image, tags added or removed, status changes with the status light, followers and assignees added or removed, lock, unlock, archive and unarchive, note changes, planned task changes, priority set or removed, "Unchecked all", checklist signatures with the signature image, notifications, and schedule changes.

It leaves out "Created Task", title changes, checklist item changes, and time and cost entries. It also drops every message type it doesn't know, which includes newer activity such as due dates, rooms, areas, assets, approvals, and copies and moves. Messages deleted in the app still show.

## Inputs

None. The checklist checkboxes are display-only: clicking one runs a handler that does nothing and saves nothing.

## Actions

| Action                                                               | Who                  | What happens                                                                                                                                                                                                  | API                                                                                                                                                                                                                                          |
| -------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the page                                                        | Anyone with the link | Loads the task or asset behind the token. The page sends the shared basic-auth login built into the app. The response carries far more than the page shows, such as users' email addresses and mobile numbers | [`GET /g-job/{jobToken}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-g-jobjobtoken), which calls [`POST ?action=guest_job_data`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionguest_job_data) |
| "Log In"                                                             | Anyone               | Opens the web app's sign-in page in a new tab. The small-screen menu's link points at `/sign-in` instead of `/auth/sign-in`                                                                                   | -                                                                                                                                                                                                                                            |
| Click the task image                                                 | Anyone               | Opens the photo in a new tab; does nothing when there is no photo                                                                                                                                             | -                                                                                                                                                                                                                                            |
| Click a photo, sketch, signature or changed task image in "Messages" | Anyone               | Opens the file in a new tab                                                                                                                                                                                   | -                                                                                                                                                                                                                                            |
| Click a document in "Messages"                                       | Anyone               | Opens the file in a new tab                                                                                                                                                                                   | -                                                                                                                                                                                                                                            |
| Play a video or voice message                                        | Anyone               | Plays it in place with the browser's player                                                                                                                                                                   | -                                                                                                                                                                                                                                            |
| Click a quoted message                                               | Anyone               | Scrolls to the original message                                                                                                                                                                               | -                                                                                                                                                                                                                                            |
| Click a checklist photo or video                                     | Anyone               | Opens a full-screen gallery of that item's photos and videos, starting at the one clicked; videos play on their own                                                                                           | -                                                                                                                                                                                                                                            |
| Click a checklist row or attribute panel header                      | Anyone               | Collapses or expands it                                                                                                                                                                                       | -                                                                                                                                                                                                                                            |

## States

* **Loading:** placeholders in place of the expiry, the task card, each left-column block and the messages.
* **Empty:** blocks without content stay hidden (note, checklist, tags). "Users" always shows its three headings, "Messages" its title, and the image block its placeholder.
* **Error:** an expired, unknown or switched-off link, and any failed request, show "Access to this task has expired." and "Please contact the task owner if you require access to this task.", with the header but without "Access expires".
* **No permission:** none; the token alone grants access. A task deleted after it was shared stays visible until the link expires.
* **Offline:** treated as an error, so it shows the expired message.

## Where links come from

The page never creates links. They expire at the time chosen when they were made; no app or API lists or revokes them.

| Source                                                                                                                                                                                                                                  | Lifetime                                          | API                                                                                                                                                                              |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Web: "Share", "Task URL", "Generate Task URL" on a task (asset wording on an asset)                                                                                                                                                     | 1 day, 1 week, 1 month (default) or 1 year        | [`POST /v1/app/tasks/generate-url`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksgenerate-url)                                                     |
| iOS and Android: the share option in the task or asset menu                                                                                                                                                                             | 1 day, 1 week or 1 month; Android starts on 1 day | [`POST ?action=generate_task_url`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actiongenerate_task_url), which doesn't check that the user can see the task |
| Email to a contractor assigned to the task                                                                                                                                                                                              | 1 year                                            | [`POST /v1/app/tasks/notify-contractor`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksnotify-contractor)                                           |
| A QR form whose success page has the share link turned on: the link shows on the confirmation page and, when the guest gives an email address, goes by email, with "Tracking link (...) has been sent via email" added to the task chat | 1 year                                            | The QR form submit in authpy ([QR form](https://docs.snapfix.com/how-the-apps-work/screens/qr/form.md))                                                                          |


---

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