Files
coder/docs/reference/cli/sharing/remove.md
T
Nick Vigilante 0d1225694e feat: show coder sharing in CLI help and reference docs (#30141)
`coder sharing` has been hidden since it was added behind an experiment,
although Shared Workspaces is GA and the prose docs already use it.

This removes `Hidden: true`, regenerates `docs/reference/cli/sharing/*`,
and adds the pages to the docs manifest.
The shared workspaces guide and the persistent shared workspaces
tutorial now link to the new reference.

**Behavior change:** `coder sharing` and its subcommands now appear in
`coder --help`.
The commands themselves are unchanged.
The `sharing remove --user/--group` help text previously said "to share
the workspace with"; it now says "to remove from the workspace".

<details>
<summary>Decisions</summary>

- Follow-up not in this PR: `DELETE /workspaces/{workspace}/acl` has no
CLI caller.

</details>

Closes [CLI-22](https://linear.app/codercom/issue/CLI-22)

_This PR was generated by Coder Agents on behalf of @nickvigilante._
2026-09-30 21:29:51 +00:00

1.0 KiB
Generated

title, description
title description
`coder sharing remove` Remove shared access for users or groups from a workspace.

Remove shared access for users or groups from a workspace.

Aliases:

  • unshare
  • rm

Usage

coder sharing remove [flags] <workspace> --user <user> --group <group>

Description

This command fails if workspace sharing is disabled for the deployment, or if the organization's sharing policy doesn't allow sharing the workspace. See https://coder.com/docs/user-guides/shared-workspaces#policies for sharing policies.

Options

--user

Type string-array

A comma separated list of users to remove from the workspace.

--group

Type string-array

A comma separated list of groups to remove from the workspace.