---
title: "Set Mcp Server Instance Sharing"
method: PUT
path: "/v1/workspaces/{workspace}/mcp-server-instances/{instance_id}/sharing"
tags: ["v1", "protected", "mcp-server-instances"]
---

# Set Mcp Server Instance Sharing

`PUT /v1/workspaces/{workspace}/mcp-server-instances/{instance_id}/sharing`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/agentarea/apis/agentarea-api/docs/v1/workspaces/:workspace/mcp-server-instances/:instance_id/sharing/put.ts> (a function with typed inputs; its response is checked against the schema)

Share the connection with the workspace, or make it its owner's again.

## Path parameters

- `instance_id` string, uuid, required
- `workspace` string, required: Slug of the workspace the request acts in

## Request body

- ConnectionSharingRequest
  - `shared` boolean, required

## Response `200`

Successful Response

- MCPServerInstanceResponse
  - `auth_config_id` union
    - string, uuid
    - string
  - `cost` object, nullable
  - `created_at` string, date-time, required
  - `description` string, nullable, required
  - `events` object, nullable
  - `id` string, uuid, required
  - `is_owner` boolean
  - `json_spec` object, required
  - `last_dispatch` object, nullable
  - `managed_by` string, nullable
  - `name` string, required
  - `personal` boolean
  - `server_spec_id` string, required
  - `tools` object[], nullable
  - `transport` 'url' | 'docker' | 'command' | 'bundle', required: How a connection is reached: the instance's ``transport`` column, set once at creation.
  - `updated_at` string, date-time, required
  - `verification` object, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-10** `4662804c264b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/workspaces/:workspace/mcp-server-instances/:instance_id/sharing/put.md)

---

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