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

# Asset 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/assets/asset-detail.md).
{% endhint %}

One asset: its photo, codes and attributes, details, documents and messages, and its tasks and planned tasks.

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

* **Where:** web `/asset-register/:id/asset/:assetId`; iOS and Android: [Asset list](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-list.md) > an asset, or a code found by the [Code scanner](https://docs.snapfix.com/how-the-apps-work/screens/assets/code-scanner.md). An asset linked to a task opens here from [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#users-tags-rooms-assets-and-compliance).
* **Who:** members who may view the asset: admins, members with "View All Tasks", the creator, assignees and followers ([`GET /v1/app/assets/{uuid}`](https://docs.snapfix.com/engineering-reference/api/assets.md#get-v1appassetsuuid)). What each can change follows the register's task permissions ([Who can do what](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#who-can-do-what)). The apps apply the same rules to the device copy.
* **Feature:** [Asset registers](https://docs.snapfix.com/product/features/assets/asset-registers.md), [Asset tasks](https://docs.snapfix.com/product/features/assets/asset-tasks.md), [Asset codes](https://docs.snapfix.com/product/features/assets/asset-codes.md)

An asset is a task in a register, so the web page reuses the task parts for the title, status, actions, note, users, checklist, documents, chat and activity ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md)). This page covers what differs for assets.

## Layout

**Web**, under a header with the back button, the register's name and a gear button (tooltip "Settings") that opens [Asset register settings](https://docs.snapfix.com/how-the-apps-work/screens/assets/register-settings.md):

1. A title bar: the asset name with a pencil, the status buttons (red, amber, green; the asset's colour is marked), "Share", the "Actions" menu, and the "Previous" and "Next" arrows.
2. Left column: the photo, or the large text (a click opens the image dialog), with a quick-action bar while the asset is neither locked nor archived (the users button and the priority star). Below it: the note ("Write a note here..."), and the last viewed time and activity.
3. Centre column, tabs "Details", "Documents" and "Messages". Details holds the [attributes](#attributes-web), the users ("Created by", "Assigned to") and the checklist. Documents lists the files posted to the asset's chat. Messages is the asset's chat.
4. Right column, tabs "Tasks" and "Planned Tasks". Tasks lists the tasks linked to the asset, with the red, amber and green counts, "Total cost", "Total time" and the search "Search reactive tasks". Planned Tasks lists the asset's planned tasks.

**iOS:** a header (the asset name with rename, red, amber and green buttons, an update counter and a menu) and five bottom tabs, "ASSET", "TASKS", "DOCS", "DETAILS" and "MESSAGES". ASSET holds the photo or large text (download, share, map, change), the register, the QR code, barcode and Smart Tag cells, and the attribute list. TASKS switches between the tasks and the planned tasks, with counts and a "+". DOCS lists documents. DETAILS holds the users, the notes, the checklist, the last viewed time and the activity.

**Android:** the same five tabs (Asset, Tasks, Docs, Details, Messages; messages open on their own screen), a similar header, and a menu with the asset items.

### Attributes (web)

* Code buttons "QR Code", "Barcode" and "Smart Tag", each shown only when the register has that kind of rule. A button is off when the asset has no value of that kind; it opens the [code dialog](#code-dialog-web).
* The "Attributes" card lists the other attributes that have a value, in their order (dates as "DD/MM/YYYY"). With no values it is an empty card with a "+" for users who may edit; with values it has a pencil and an expand arrow. A click on a value opens the [attributes dialog](#attributes-dialog-web) for users who may edit.

## Inputs

| Field                                           | Type                    | Required                             | Default           | Rules and messages                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------------------------------- | ----------------------- | ------------------------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Attribute (each register attribute)             | Text, or a date picker  | Only when the attribute is mandatory | The current value | Text: up to 1,000 characters. Date: picked only (the field is read-only), shown as "DD/MM/YYYY" and sent as a timestamp in milliseconds. An empty mandatory field shows "This field is required" under it, and "Save" opens the alert "Please fill in all mandatory fields: {{fields}}" with the attribute names; the dialog stays open. Only changed values are sent. |
| QR code, barcode, Smart Tag                     | Code                    | When mandatory                       | None              | Web: shown, copied, downloaded and removed only; the web cannot set a code. Apps: scanned with the camera or read by NFC ([Code scanner](https://docs.snapfix.com/how-the-apps-work/screens/assets/code-scanner.md)).                                                                                                                                                  |
| Name, note, large text, photo, status, priority | As on the task screen   | Per the task rules                   | Current           | [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#inputs). The note editor reads "Write a note here..." with a counter ("0/2000") and "Cancel" and "Save".                                                                                                                                                                         |
| Users                                           | Assignees and followers | No                                   | Current           | The "Assigned to" dialog, from the card or the photo's users button.                                                                                                                                                                                                                                                                                                   |

## Actions

| Action                                                                   | Who                                                                               | What happens                                                                                                                                                                                                                                                                                                                                                         | API                                                                                                                                                                                                                                                      |
| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rename                                                                   | Users who may change the asset                                                    | Opens the name editor.                                                                                                                                                                                                                                                                                                                                               | [`PUT /v1/app/assets/{uuid}`](https://docs.snapfix.com/engineering-reference/api/assets.md#put-v1appassetsuuid) with `action` `title`                                                                                                                    |
| Change status                                                            | With the colour permission                                                        | Sets red, amber or green; the chat records it.                                                                                                                                                                                                                                                                                                                       | [`PUT /v1/app/assets/{uuid}`](https://docs.snapfix.com/engineering-reference/api/assets.md#put-v1appassetsuuid) with `action` `color`                                                                                                                    |
| Change priority                                                          | Users who may change the asset                                                    | The star sets or clears the priority.                                                                                                                                                                                                                                                                                                                                | [`PUT /v1/app/assets/{uuid}`](https://docs.snapfix.com/engineering-reference/api/assets.md#put-v1appassetsuuid) with `action` `priority`                                                                                                                 |
| Change the photo, edit the note                                          | Users who may change the asset                                                    | The image dialog ([Task image](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#task-image)) and the note editor.                                                                                                                                                                                                                             | [`PUT /v1/app/assets/{uuid}`](https://docs.snapfix.com/engineering-reference/api/assets.md#put-v1appassetsuuid) with `action` `image` or `description`                                                                                                   |
| Assign users, follow                                                     | Users who may change the asset                                                    | Adds or removes assignees and followers.                                                                                                                                                                                                                                                                                                                             | [`POST /v1/app/tasks/assign/multi`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksassignmulti), [`POST /v1/app/tasks/follow/multi`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksfollowmulti) |
| Edit attributes                                                          | Users who may change the asset                                                    | Opens the [attributes dialog](#attributes-dialog-web).                                                                                                                                                                                                                                                                                                               | [`POST /v1/app/assets/save-attributes`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetssave-attributes)                                                                                                                    |
| Open a code                                                              | Anyone who sees it                                                                | Opens the [code dialog](#code-dialog-web).                                                                                                                                                                                                                                                                                                                           | None                                                                                                                                                                                                                                                     |
| Copy a code                                                              | Anyone who sees it                                                                | Copies the value; the toast "Copied to clipboard".                                                                                                                                                                                                                                                                                                                   | None                                                                                                                                                                                                                                                     |
| Download a code                                                          | Anyone who sees it                                                                | Saves the code picture as `{attribute name}-{time}.jpg`; the file holds PNG data.                                                                                                                                                                                                                                                                                    | None                                                                                                                                                                                                                                                     |
| Remove a code                                                            | Users who may change the asset                                                    | "Remove QR Code", "Remove Barcode" or "Remove Smart Tag" clears the value at once, with no confirmation. The code button stays on until the page reloads.                                                                                                                                                                                                            | [`POST /v1/app/assets/save-attributes`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetssave-attributes) with an empty value                                                                                                |
| Checklist                                                                | Users who may change the asset                                                    | The card's button opens the "Add Checklist to Task" picker, with "Search Templates", "Create New Checklist" and "Save"; the title says "Task" on an asset. The checklist menu has "Remove from Asset".                                                                                                                                                               | [Checklists API](https://docs.snapfix.com/engineering-reference/api/checklists.md)                                                                                                                                                                       |
| Upload a document                                                        | Users who may attach files                                                        | "Upload documents and files"; the file becomes a document message in the asset's chat.                                                                                                                                                                                                                                                                               | [`POST /v1/app/chat/file`](https://docs.snapfix.com/engineering-reference/api/chat.md#post-v1appchatfile)                                                                                                                                                |
| Open, download, share or delete a document                               | Delete: users with the delete permission                                          | The row menu has "Open", "Download", "Share" and "Delete"; delete asks "Are you sure you want to delete this document?" and deletes the chat message.                                                                                                                                                                                                                | [`DELETE /v1/app/chat/{uuid}`](https://docs.snapfix.com/engineering-reference/api/chat.md#delete-v1appchatuuid)                                                                                                                                          |
| Messages                                                                 | Users who may change the asset                                                    | Text, photos, videos, documents and voice notes in the asset's chat, as for tasks.                                                                                                                                                                                                                                                                                   | [`POST /v1/app/chat`](https://docs.snapfix.com/engineering-reference/api/chat.md#post-v1appchat)                                                                                                                                                         |
| Tasks: list                                                              | Anyone who sees the asset                                                         | Lists the linked tasks, 20 at a time. The search "Search reactive tasks" runs one second after the last key press and matches reference, title and description; a clear button shows while it has text. A task opens its detail.                                                                                                                                     | [`GET /v1/app/assets/{uuid}/jobs`](https://docs.snapfix.com/engineering-reference/api/assets.md#get-v1appassetsuuidjobs)                                                                                                                                 |
| Tasks: "+"                                                               | Users who may create tasks in some group                                          | Opens "Add a Task" ("Task name", a large-text box with a "0 / 50" counter, "Next"), then "Add task to a Group" to pick the group and "Save". The new task is linked to the asset.                                                                                                                                                                                    | [`POST /v1/app/tasks`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasks)                                                                                                                                                      |
| Planned tasks: list                                                      | Anyone who sees the asset                                                         | Lists the asset's planned tasks by date, 20 at a time \[[ASK-107](https://github.com/snapfix/docs/blob/main/ASK.md#ask-107-does-the-asset-planned-tasks-tab-load-its-list)]. A planned task opens its editor.                                                                                                                                                        | [`POST /v4/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v4jobs) with `uuid_assets`                                                                                                                                          |
| Planned tasks: "+", or "Create Planned Task For This Asset" in "Actions" | Users who may change the asset, with "Create Planned Tasks" and "Create New Task" | Opens [Planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md) at `/plan/planned-task/create/task/{asset}` with the group type `assets`. The group field starts empty ("Select a group \*").                                                                                                                                       | None until saved                                                                                                                                                                                                                                         |
| "Share"                                                                  | Anyone who sees the asset                                                         | Opens "Share Asset" with "Asset Report" (the summary with cost and time, the checklist summary, images and the audit trail with messages) and "Asset URL" (a link anyone who receives it can open), as for tasks ([Share task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#share-task)).                                                 | As for tasks                                                                                                                                                                                                                                             |
| "Copy Asset to Register", "Move Asset to Register"                       | Admins of the register with "Create New Task"                                     | Opens the [copy or move dialog](#copy-or-move-web). After a move the page goes back.                                                                                                                                                                                                                                                                                 | [`POST /v1/app/assets/copy`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetscopy), [`POST /v1/app/assets/move`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsmove)                         |
| "Duplicate Asset (all messages)", "Duplicate Asset (no messages)"        | "Create New Task"                                                                 | After a "No" or "Yes" question, copies the asset into the same register; the copy's title gets " Copy". The no-messages text reads "Makes a copy of this Asset in this Asset Register, and includes only the initial photo/image, with the assigned users." The page stays on the original. The copy's chat starts with a "created" line that names the type "Task". | [`POST /v1/app/assets/copy`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetscopy)                                                                                                                                          |
| "Lock" or unlock                                                         | Users who may change the asset; the API allows admins and the creator             | Toggles the lock at once.                                                                                                                                                                                                                                                                                                                                            | [`PUT /v1/app/assets/{uuid}`](https://docs.snapfix.com/engineering-reference/api/assets.md#put-v1appassetsuuid) with `action` `lock`                                                                                                                     |
| "Archive" or unarchive                                                   | "Delete or Archive Tasks"                                                         | Toggles the archive at once.                                                                                                                                                                                                                                                                                                                                         | [`PUT /v1/app/assets/{uuid}`](https://docs.snapfix.com/engineering-reference/api/assets.md#put-v1appassetsuuid) with `action` `archive`                                                                                                                  |
| "Delete"                                                                 | "Delete or Archive Tasks"                                                         | "Delete Asset": "Are you sure you want to delete the asset?", "Deleting the asset means it will be removed from all tasks and schedules it is associated with." and "Deleting the Asset can not be undone.", with "Cancel" and "Delete". The text can show stray markup. After the delete the page goes back to the page before, which is not always the asset list. | [`DELETE /v1/app/assets/{uuid}`](https://docs.snapfix.com/engineering-reference/api/assets.md#delete-v1appassetsuuid)                                                                                                                                    |
| "Previous", "Next"                                                       | Anyone                                                                            | Opens the neighbouring asset of the list the user came from; off when no list is stored.                                                                                                                                                                                                                                                                             | None                                                                                                                                                                                                                                                     |

## States

* **Loading:** web: a skeleton until the asset arrives. Apps: the device copy at once.
* **Locked or archived:** the web hides the quick actions on the photo and disables the document upload button. The chat follows the task rules ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#states)).
* **Empty:** no tasks: "Manage your Tasks in a Snap!" and "To add a task, click on the + button." No planned tasks: "Manage your Planned Tasks in a Snap!" and "To create your first "Planned Task", click the \[+] button." No documents: "Snap & Store Your Documents!" and "To upload a document, tap the button.", with an upload button. No attribute values: the empty "Attributes" card.
* **Error:** web: a failed asset or register request shows the server's message in an error alert, and the page goes back to the previous page, or to the asset list when there is none. A refused attribute save shows the server's raw validation text in an "Alert", such as "The attributes.2.value field is required when attributes.2.uuid is not present."; nothing is saved.
* **No permission:** an asset the user may not view answers "Access denied", shown as above. The edit controls are hidden from users who may not change the asset. "You don't have permission to view this asset" is the message of a task's asset links ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#assets)), not of this page.
* **Offline (mobile):** the apps read and write the device copy and sync later.

## Dialogs and sheets

### Attributes dialog (web)

Title "Attributes". One row per register attribute: the name (with a red asterisk when mandatory) and its field, then "Cancel" and "Save". The rules are in [Inputs](#inputs). The dialog leaves out the first QR, barcode and NFC rule, which have their [code dialog](#code-dialog-web). The same dialog opens from "Add an Asset" when the register has a mandatory attribute ([Asset list](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-list.md#add-an-asset-web)).

### Code dialog (web)

Title "QR Code", "Barcode" or "Smart Tag". The code picture (a QR code, a barcode, or a Smart Tag picture), the value with a copy button, and "Remove QR Code", "Remove Barcode" or "Remove Smart Tag" (for users who may change the asset) and "Download".

### Copy or move (web)

Title "Choose an Asset Register". "Choose the Asset Register to copy the Asset into" (or "move"), and "(Note: you must be an Admin in both Asset Registers)", while the app checks admin only in this register and "Create New Task" in the target \[[ASK-21](https://github.com/snapfix/docs/blob/main/ASK.md#ask-21-who-may-copy-or-move-a-task-and-what-should-the-tag-options-do)]. The list holds the other registers; this one is left out. "Save" stays off until one is picked. A target where the user may not create tasks gets "Access denied" / "Oops, you don't have the right permissions to create task in this group. Reach out to the group admin to review your permissions." When assignees or followers are not in the target, "Confirm Copy" or "Confirm Move" lists them ("The tags/users listed below do not exist in the chosen Group." … "By confirming, these will be created in the chosen Group."). Then "This asset will be copied to the following Asset Register: {{$1}}" (or "moved").

### Other dialogs (web)

The image dialog ([Task image](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#task-image)), "Assigned to" ("Find users", "Cancel", "Save"), the checklist picker, "Share Asset", "Delete Asset", and the new-task dialog ([Add a task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md)).

### Apps

The attributes editor: iOS `EditAssetAttributesVC` (a sheet from the attributes section's edit button, or "Attributes" in the options sheet); Android `AssetAttributeBottomSheet` (from the Asset tab). An empty code row can be scanned ([Code scanner](https://docs.snapfix.com/how-the-apps-work/screens/assets/code-scanner.md)). The header menu is the task options sheet with asset items, including "Copy Asset to Register", "Move Asset to Register" and the two duplicates ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#dialogs-and-sheets)).

## Platform differences

| Topic                 | Web                                                                                                             | iOS                                                                                                                                                                  | Android                                                                                                        |
| --------------------- | --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Layout                | Three columns, two tab rows                                                                                     | Five bottom tabs                                                                                                                                                     | Five tabs; messages on their own screen                                                                        |
| Data                  | The server                                                                                                      | The device copy, synced                                                                                                                                              | The device copy, synced                                                                                        |
| Codes                 | Shown, copied, downloaded, removed                                                                              | Also scanned into an empty row                                                                                                                                       | Also scanned (Asset tab prompt)                                                                                |
| Planned tasks         | Planned Tasks tab, [`POST /v4/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v4jobs) | TASKS tab segment, [`POST /v3/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v3jobs), which lists other assets' created planned tasks too | [`POST /v3/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v3jobs), the same problem |
| Copy, move, duplicate | "Actions" menu                                                                                                  | Header menu                                                                                                                                                          | Header menu                                                                                                    |
| Documents             | Documents tab                                                                                                   | DOCS tab                                                                                                                                                             | Docs tab                                                                                                       |


---

# 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/assets/asset-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.
