# shared

Manage other people's data shared with you

## Get all dashboards shared with the user

 - [GET /v1/shared](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_getsharedwithme.md): Retrieves all dashboards that other users have shared with the authenticated user. For extra context visit: Sharing Context

## Delete a shared dashboard

 - [DELETE /v1/shared](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_deleteshared.md): Removes a shared dashboard from the authenticated user's list. This effectively stops viewing access to the shared dashboard without notifying the owner. For extra context visit: Sharing Context

## Get all groups owned by the user

 - [GET /v1/shared/groups](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_getgroupsownedbyuser.md): Retrieves all groups created by the authenticated user, including the members of each group. Groups allow users to organize their shared dashboards. For extra context visit: Sharing Context

## Create a new group

 - [POST /v1/shared/groups](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_creategroup.md): Creates a new group for organizing shared dashboards. Groups allow users to categorize and manage multiple shared users more efficiently. For extra context visit: Sharing Context

## Rename a group

 - [PATCH /v1/shared/groups/{groupId}](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_renamegroup.md): Updates the name of an existing group. The user must own the group to rename it. For extra context visit: Sharing Context

## Delete a group

 - [DELETE /v1/shared/groups/{groupId}](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_deletegroup.md): Deletes a group. The user must own the group to delete it. Deleting a group does not affect the shared dashboards themselves, only the grouping. For extra context visit: Sharing Context

## Update custom name and icon color for a shared dashboard

 - [POST /v1/shared/custom](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_updatecustom.md): Allows users to personalize how a shared dashboard appears to them by setting a custom name and icon color. This only affects the viewing user's experience and does not change the dashboard for others. For extra context visit: Sharing Context

## Upload custom profile picture for a shared dashboard

 - [POST /v1/shared/custom/profile-picture](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_uploadcustomprofilepicture.md): Uploads a custom profile picture for a shared dashboard. The user must have access to the shared dashboard. Max file size is 5MB. Allowed formats: jpg, png, webp. For extra context visit: Sharing Context

## Delete custom profile picture for a shared dashboard

 - [DELETE /v1/shared/custom/profile-picture](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_deletecustomprofilepicture.md): Deletes the custom profile picture for a shared dashboard. The user must have access to the shared dashboard. For extra context visit: Sharing Context

## Add a user to a group

 - [POST /v1/shared/groups/{groupId}/members](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_addusertogroup.md): Adds a shared user to an existing group. The user to be added must already be sharing their dashboard with the authenticated user. For extra context visit: Sharing Context

## Remove a user from a group

 - [DELETE /v1/shared/groups/{groupId}/members](https://docs.api.nowatch.tech/apis/shared/sharedcontroller_removeuserfromgroup.md): Removes a shared user from a group. This does not stop the dashboard sharing relationship, it only removes them from the group. For extra context visit: Sharing Context