# 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

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](/pinpoint-guide/user-guides/desktop-laptop/workspaces.md#roles-in-workspaces).
* Each shared workspace also includes a "Workspace logs", which logs user activity in the workspace.&#x20;

  > Users should ensure that materials uploaded to shared workspaces are in line with the expectations of their supervisors.

<figure><img src="/files/0Kv3oUA6MdeQ0M1Cs6Tr" alt=""><figcaption></figcaption></figure>

## Roles in workspaces

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

Refer to the table below for an overview of the roles:

<table data-full-width="true"><thead><tr><th width="194.4296875">Functions</th><th width="140.9375" align="center">Administrator</th><th width="142.7734375" 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>Workspace Logs</td><td align="center">✅</td><td align="center">❌</td><td align="center">❌</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>View workspace logs</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 </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>

## How to create a workspace

1. Click the "**+ Add**" icon in the workspace tab.

   <figure><img src="/files/C5dIqEZ8VnUVCgJUFbUX" alt=""><figcaption></figcaption></figure>
2. Type in the desired workspace name.
3. Click the "Save" button.

   <figure><img src="/files/80FTUqIcvmKvWC3C76D2" alt=""><figcaption></figcaption></figure>
4. Select "Add new media" to start [uploading](/pinpoint-guide/user-guides/desktop-laptop/uploading.md) media to your new workspace.

## Renaming workspace

1. In workspace settings, select "Manage shared workspace".
2. Select "Rename workspace"&#x20;

   <figure><img src="/files/VxeJJKlAbyG8GomD3Yht" alt=""><figcaption></figcaption></figure>
3. Enter a new workspace name and Click "Save".

   <figure><img src="/files/VzmLLcW46W0FtiLy81NQ" alt=""><figcaption></figcaption></figure>
4. The new workspace name will be reflected for all users upon refresh.

## Leaving workspace

1. In workspace settings, select "Leave workspace" from the drop-down list.<br>

   <figure><img src="/files/Edx5g78mxNFaArgorHhl" alt=""><figcaption></figcaption></figure>
2. Select "Leave workspace" on the "Leave workspace" pop-up.<br>

   <figure><img src="/files/HiCZZhJgpDd4upW3CFHQ" alt=""><figcaption></figcaption></figure>
3. You will now have left the workspace. Others still in the workspace will continue to have access to its media.

## Deleting workspace

1. In workspace settings, select "Delete workspace" from the drop-down list.

   <figure><img src="/files/ZrA6cdZGTp0PFe5GbUJW" alt=""><figcaption></figcaption></figure>
2. Select "Delete" on the "Delete workspace" pop-up.

   <figure><img src="/files/Tp9rEO7BckGHTJvrxQqV" alt=""><figcaption><p>Check that you are in the correct workspace before deleting</p></figcaption></figure>
3. 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:**

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

   <figure><img src="/files/ujhywamRDTdXvLKXN8Vj" alt=""><figcaption></figcaption></figure>
2. 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>).
3. Select a role from the dropdown list and Click "Add collaborator".
   * To see the permission given to each role, click the tooltip or click [here](#managing-access).

     <figure><img src="/files/6CtkQ7roChDTKa3GU8KG" alt=""><figcaption></figcaption></figure>
4. Verify that a new user is added at the top of the list.
5. If the user is new to Pinpoint, the invitation to the workspace will be sent to them through their emails. They will be added to the workspace automatically after they login for the first time.

### **Removing User access:**

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

   <figure><img src="/files/ujhywamRDTdXvLKXN8Vj" alt=""><figcaption></figcaption></figure>
3. Click the delete icon (bin) on the desired user to remove their access.

   <figure><img src="/files/PhxQqGxdVtV4GFW4nvMg" alt=""><figcaption></figcaption></figure>

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

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

   <figure><img src="/files/ujhywamRDTdXvLKXN8Vj" alt=""><figcaption></figcaption></figure>
3. Click the drop-down list beside the user's email and select the desired role for collaborator.&#x20;

   <figure><img src="/files/mVkz8FDcz17Jib7o2dGq" alt=""><figcaption></figcaption></figure>

## Workspace logs&#x20;

Shared workspaces includes a "log" which records user activity in the workspace.&#x20;

* Workspace logs can only be accessed by admins.
* Activity logs are kept for 60 days.
* Activities logged:
  * Uploading to / deleting images in the workspace.
  * Adding / removal of users to the workspace

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

   <figure><img src="/files/Zy5InbVmC5F8CFTyr8Mi" alt=""><figcaption></figcaption></figure>
2. Filters can also be used to narrow down workspace log activities.

   <figure><img src="/files/P5EHSq0FxN9mgmEieSye" alt=""><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/desktop-laptop/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.
