---
title: "Update Org External Sharing"
method: PATCH
path: "/orgs/{org_id}"
tags: ["orgs"]
---

# Update Org External Sharing

`PATCH /orgs/{org_id}`

Owners-only toggle of org-wide external sharing.

- Non-owners (or non-members) get 403.
- Missing org → 404.
- Idempotent: when the value already matches the existing row, no audit-log row is written
  and the existing row is returned unchanged.

## Path parameters

- `org_id` string, required

## Request body

- UpdateOrgExternalSharingRequest — Typed body for the PATCH endpoint — refuses unknown fields so callers fail loudly when the schema drifts rather than silently no-opping on a misspelled key.
  - `external_sharing_enabled` boolean, required

## Response `200`

Successful Response

- OrgResponse
  - `id` string, required
  - `name` string, required
  - `claimed_domain` string, nullable
  - `external_sharing_enabled` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.dev/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/revisions/28bdface01df/schema)