# Workspaces

Want to share media with team members or users from other agencies?  Pinpoint's "**Workspaces**" feature allows users to establish a **shared environment** where multiple users can **upload and view media securely.** &#x20;

## "Personal" and "Shared" workspaces <a href="#personal-and-shared-workspaces" id="personal-and-shared-workspaces"></a>

Personal workspace:

* Every user has a private workspace called "Personal" and media stored here are only accessible by the user.
* This workspace cannot be shared with other users.

**Shared workspaces:**

* Shared workspaces can be created by users for collaboration with other users based on assigned [roles](#roles-in-workspaces-mobile-version).
* Each shared workspace also includes a "Workspace logs", which logs user activity in the workspace.

  > Users should ensure that materials uploaded to shared workspaces are in line with the expectations of their supervisors.
  >
  > **Note that "Workspace Logs" is currently&#x20;**<mark style="color:red;">**not available**</mark>**&#x20;on mobile.**

## Roles in workspaces (Mobile Version)

Pinpoint allows administrators to set specific levels of permissions, based on these defined roles:

**Administrator**:&#x20;

* Has full control over the workspace, including the ability to manage other users and make changes to workspace settings.
* **Administrators** can also modify the roles of other administrators including themselves in the workspace. Once forfeited, all administrator privileges for that workspace will be revoked unless reassigned.
* There must always be at least one **administrator** assigned to a workspace at all times. Consequently, if a user is the sole **administrator**, they cannot remove themselves from the workspace without appointing another user as an **administrator**.
* By default, workspace owners are set as **Administrators**

**Contributor**:&#x20;

* Can upload and edit media within the workspace.

**Viewer**:&#x20;

* Has view-only access to the workspace and cannot make any changes

<table data-full-width="true"><thead><tr><th width="235">Functions</th><th align="center">Administrator</th><th align="center">Contributor</th><th align="center">Viewer</th></tr></thead><tbody><tr><td>Manage access                                 </td><td align="center">✅</td><td align="center"><strong>View-only</strong></td><td align="center"><strong>View-only</strong></td></tr><tr><td>Rename workspace                                         </td><td align="center">✅</td><td align="center">❌</td><td align="center">❌</td></tr><tr><td>Delete workspace      </td><td align="center">✅</td><td align="center">❌</td><td align="center">❌</td></tr><tr><td>Delete media</td><td align="center">✅</td><td align="center">❌</td><td align="center">❌</td></tr><tr><td>Upload media</td><td align="center">✅</td><td align="center">✅</td><td align="center">❌</td></tr><tr><td>Edit metadata</td><td align="center">✅</td><td align="center">✅</td><td align="center"><strong>View-only</strong></td></tr><tr><td>Filter functions (Limited)</td><td align="center">✅</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Download media</td><td align="center">✅</td><td align="center">✅</td><td align="center">✅</td></tr></tbody></table>

> Filter functions are currently only limited to tags on the mobile version

* User can **verify** their **role** above the workspace name.

<figure><img src="/files/qnLe3JZEVlh7koLVzdtl" alt="" width="285"><figcaption></figcaption></figure>

## Workspace Settings

Can be identified by the "Gear icon" [⚙️](https://emojipedia.org/gear) . A**dmins** can modify workspace settings which includes:

* Manage workspace access
* Renaming workspace
* Deleting workspace

<figure><img src="/files/Gj4QhFNFfxFX9cxJnsHW" alt="" width="285"><figcaption></figcaption></figure>

## How to create a workspace

1. Select "**+ Add new workspace**" in the workspace tab.

   <figure><img src="/files/4laV71vqpWmMwmT16iYA" alt="" width="286"><figcaption></figcaption></figure>
2. Type in the desired workspace name.
3. Select the "Save" button.

   <figure><img src="/files/EsTnb78MeQcM004tl2L8" alt="" width="375"><figcaption></figcaption></figure>

## Renaming workspace

1. Select the "Settings" Icon :gear: .
2. Select "Rename workspace"

   <figure><img src="/files/pYCGE3YlujWdc13kJ3IM" alt="" width="286"><figcaption></figcaption></figure>
3. Enter a new workspace name and Click "Save".
4. The new workspace name will be reflected for all users upon refresh.

   <figure><img src="/files/IIJDTuMPhnO1IDAPHSmY" alt="" width="375"><figcaption></figcaption></figure>

## Leaving workspace

1. Select the "Settings" Icon :gear: .&#x20;
2. Select "Leave workspace" from the drop-down list.

<figure><img src="/files/F99SLke5YvMF4Zqqtp9Y" alt="" width="188"><figcaption></figcaption></figure>

3. Select "Leave workspace" on the "Leave workspace" pop-up.

<figure><img src="/files/ihgiDJwMFGImFHvTd6xg" alt="" width="188"><figcaption></figcaption></figure>

4. You will now have left the workspace. Others still in the workspace will continue to have access to its media.

## Deleting workspace

1. Select the "Settings" Icon :gear: .&#x20;
2. Select "Delete workspace" from the drop-down list.

   <figure><img src="/files/rhWGFtqhzYg0WAzAONKN" alt="" width="286"><figcaption></figcaption></figure>
3. Select "Yes" on the "Delete workspace" pop-up.

<figure><img src="/files/FVE7dOcJpePLsRL3aYqr" alt="" width="375"><figcaption><p>Check that you are in the correct workspace before deleting</p></figcaption></figure>

4. The workspace, including all media stored in it, will be deleted. Additionally, all users within the workspace will no longer have access to the workspace.

## Managing Access&#x20;

Administrators can add and remove users from their workspaces to manage their access.

### **Adding Users:**

• Users must log in to Pinpoint at least once before they can be added to a workspace.

1. In workspace settings, select "Manage shared workspace".
2. Select "Manage workspace access" from the drop-down list.

   <figure><img src="/files/iGoGxythXhQAAnBZfm2y" alt="" width="286"><figcaption></figcaption></figure>
3. Enter a valid user email address (with the domain **.gov.sg**). You can add up to 50 users at once by typing in their email addresses, separated by commas (like this: <email1@example.com>, <email2@example.com>).
4. Select a role from the dropdown list and Click "Add collaborator".
   * To see the permission given to each roles, click the tooltip or click [here](#managing-access).

     <figure><img src="/files/iJYxG9LPL1xu4H85d4aZ" alt="" width="375"><figcaption></figcaption></figure>
5. Verify that a new user is added at the top of the list.

### **Modifying User Roles:**&#x20;

1. In workspace settings, select "Manage shared workspace".
2. Select "Manage workspace access" from the drop-down list

   <figure><img src="/files/iGoGxythXhQAAnBZfm2y" alt="" width="286"><figcaption></figcaption></figure>
3. Select the role modifier (below collaborator's email )

   <figure><img src="/files/bltZwf0Tef8Mw7ImHRoS" alt="" width="375"><figcaption></figcaption></figure>
4. Select the desired role for collaborator.&#x20;

   <figure><img src="/files/oiu2BVzNZn6nYyE60RPQ" alt="" width="375"><figcaption></figcaption></figure>

### **Removing User access:**&#x20;

1. In workspace settings, select "Manage shared workspace".

2. Select "Manage workspace access" from the drop-down list

   <figure><img src="/files/iGoGxythXhQAAnBZfm2y" alt="" width="286"><figcaption></figcaption></figure>

3. Select the role modifier (below collaborator's email )

   <figure><img src="/files/bltZwf0Tef8Mw7ImHRoS" alt="" width="375"><figcaption></figcaption></figure>

4. Select "remove user"

5. User will be removed from shared workspace and will no longer have access to it.

   <figure><img src="/files/24mwJfDT7WR9T2lpHgmR" alt="" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.app.pinpoint.gov.sg/pinpoint-guide/user-guides/mobile/workspaces.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
