---
title: "Sharing targets list"
method: GET
path: "/v2/storage/sharing-targets"
tags: ["Buckets"]
---

# Sharing targets list

`GET /v2/storage/sharing-targets`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/sharing-targets`
- Auth: one of:
  - API key in header `X-StorageApi-Token`
  - API key in header `X-KBC-ManageApiToken`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/keboola/apis/keboola-storage-api/docs/v2/storage/sharing-targets/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the projects and users a bucket of the caller's project can be shared to: every project of
the organization and every admin of those projects.

Requires an admin token whose admin either has the `share` role in the project or is a member
of the project's organization. A `share`-role admin gets the lists even without organization
membership.

## Response `200`

Projects and users a bucket can be shared to.

- SharingTargetsListResponse
  - `projects` object[], required: Projects of the organization a bucket can be shared to, including the caller's own project.
    - `id` integer, required
    - `name` string, required
  - `users` object[], required: Admins of the organization's projects a bucket can be shared to, sorted by email.
    - `id` integer, required
    - `name` string, required
    - `email` string, required

## Other responses

- `403`: The token is not an admin token, or its admin has neither the `share` role in the project nor organization membership (`accessDenied`).

---

[API](https://skmtc.dev/keboola/apis/keboola-storage-api.md) - [All operations](https://skmtc.dev/keboola/apis/keboola-storage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keboola/apis/keboola-storage-api/revisions/34b5ceac0317?raw)