---
title: "Set a capsule to Private (self), Organization (View only) (org_view) or Organization (Edit) (org_edit), or whether library links may publish it"
method: PUT
path: "/api/preview/capsules/{id}/permissions"
tags: ["share"]
---

# Set a capsule to Private (self), Organization (View only) (org_view) or Organization (Edit) (org_edit), or whether library links may publish it

`PUT /api/preview/capsules/{id}/permissions`

## Request

- Base URL: `https://symbol.chat` (the document declares no server; this is the origin it was published from)
- URL: `https://symbol.chat/api/preview/capsules/{id}/permissions`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-next-auth.session-token`
  - OAuth 2
    - Authorization code: `https://mcp.symbol.chat/authorize`
    - Token URL: `https://mcp.symbol.chat/token`

## Path parameters

- `id` string, required: UUID v4 string

## Request body

- object
  - `in_library_share` boolean: Whether a link to the capsule's Type or Collection may publish this capsule. Sent alone, it changes only that.
  - `organizationId` string, nullable: UUID v4 string
  - `visibility` 'self' | 'org_view' | 'org_edit': `self` (Private), `org_view` (Organization (View only)) or `org_edit` (Organization (Edit)). Anyone with link and Public are set through `PUT /api/preview/share/visibility`.

## Response `200`

Successful response

- object
  - `in_library_share` boolean, required
  - `organizationId` string, nullable, required
  - `organizationName` string, nullable, required
  - `shared_since` string, nullable, required
  - `visibility` 'self' | 'link' | 'public' | 'org_view' | 'org_edit', required

## Changes

- **2026-10-19** `5778844d1f9e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/symbol/apis/symbol-api/changes/api/preview/capsules/:id/permissions/put.md)

---

[API](https://skmtc.dev/symbol/apis/symbol-api.md) - [All operations](https://skmtc.dev/symbol/apis/symbol-api/llms.txt) - [OpenAPI document](https://skmtc.dev/symbol/apis/symbol-api/revisions/3a2c4ebeab51?raw)