---
title: "Retrieve the sharing options available for folders. Use this endpoint to review the list of users and roles that can access your folder resources."
method: GET
path: "/folders/share"
tags: ["Folder"]
---

# Retrieve the sharing options available for folders. Use this endpoint to review the list of users and roles that can access your folder resources.

`GET /folders/share`

## Request

- Base URL: `http://localhost:5050`
- URL: `http://localhost:5050/folders/share`
- Auth: none declared
- TypeScript: <https://skmtc.dev/kameleo-io/apis/kameleo-local-api/docs/folders/share/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

OK

- SharingOptionsResponse
  - `users` User[], nullable: List of users in your team.
    - `id` string, uuid, required: Unique identifier of the user.
    - `name` string, required: Dispaly name of the user.
    - `email` string, required: Email address of the user.
  - `roles` GroupRole[], nullable: List of roles you can give the users.
    - `id` string, uuid, required: Unique identifier of the role.
    - `name` string, required: Name of the role.
    - `description` string, required: Description of the role.

## Other responses

- `401`: Unauthorized
- `default`: Error

## Changes

- **2026-08-03** `dc959e78ce25`: 2 warning
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `default`
- **2026-06-16** `4d1d53a322e2`: 4 warning, 14 info
  - removed the optional property `code` from the response with the `401` status
  - removed the optional property `code` from the response with the `default` status
  - removed the optional property `error` from the response with the `401` status
  - removed the optional property `error` from the response with the `default` status
  - …14 more
- **2026-03-05** `7d950a98d019`: 6 breaking, 8 warning, 4 info
  - removed the required property `errorCode` from the response with the `401` status
  - removed the required property `errorCode` from the response with the `default` status
  - removed the required property `status` from the response with the `401` status
  - removed the required property `status` from the response with the `default` status
  - …14 more

[Operation history](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/changes/folders/share/get.md)

---

[API](https://skmtc.dev/kameleo-io/apis/kameleo-local-api.md) - [All operations](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/revisions/d3225562612a?raw)