---
title: "Share Bucket To Organization Project"
method: POST
path: "/v2/storage/buckets/{bucketId}/share-organization-project"
tags: ["Buckets"]
---

# Share Bucket To Organization Project

`POST /v2/storage/buckets/{bucketId}/share-organization-project`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/buckets/{bucketId}/share-organization-project`
- 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/buckets/:bucketId/share-organization-project/post.ts> (a function with typed inputs; its response is checked against the schema)

[Enables sharing](https://help.keboola.com/storage/buckets/sharing/) or **updates sharing** for this bucket within the organization. Any member of a project within the organization will be able to link to this bucket from their project. This operation is available only for organization administrators. Sharing is set up in a background job; to see the job detail use the Job Detail endpoint.

## Path parameters

- `bucketId` string, required

## Response `202`

Share job enqueued; returns job details.

- BucketShareOrganizationProjectResponse
  - `id` integer, required: Job ID.
  - `status` string, required: Job status.
  - `url` string, required: URL to retrieve job details.
  - `tableId` string, nullable, required: Table identifier if applicable.
  - `operationName` string, required: Name of the operation.
  - `operationParams` object, required: Parameters passed to the operation.
  - `createdTime` string, date-time, required: Job creation timestamp.
  - `startTime` string, date-time, nullable, required: Job start timestamp.
  - `endTime` string, date-time, nullable, required: Job completion timestamp.
  - `runId` string, nullable, required: Unique run identifier.
  - `results` object, nullable, required: Operation results; content varies.
  - `creatorToken` object, required: Creator token information.
    - `id` integer, required: ID of the token that created this job.
    - `description` string, nullable, required: Description of the creator token.
  - `metrics` object, required: Job execution metrics.
  - `error` object: Job error information. Present only when the job failed.
    - `code` string, required: Error code if job failed.
    - `message` string, required: Error message if job failed.
    - `exceptionId` string, required: Exception identifier.

## Other responses

- `400`: Sharing a bucket in a development branch is not supported (`storage.buckets.devBranchBucketSharingNotSupported`).
- `403`: The token cannot manage the bucket or is not an organization administrator (`accessDenied`).
- `404`: The bucket was not found (`storage.buckets.notFound`).
- `501`: Operation is not supported for Snowflake Partner Connect projects (`storage.snowflakePartnerConnect.notSupported`).

---

[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)