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

# Share Bucket To Organization

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

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/buckets/{bucketId}/share-organization`
- 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/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 organization member will be able to link to this bucket from any project within the organization. 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.

- BucketShareOrganizationResponse
  - `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`).
- `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)