forge workspace

Manage workspaces — create, list, update, delete, and manage members and grants.

Command

forge workspace <subcommand> [args]

None. Use a

<subcommand>

— run

forge --help

for per-subcommand arguments.

None.

Subcommand	Usage
`list`	`forge workspace list [--status S] [--limit N] [--cursor X]`
`create`	`forge workspace create --name STR [--slug S] [--description S] [--tier T]`
`get`	`forge workspace get <workspaceId>`
`update`	`forge workspace update <workspaceId> [--name] [--tier]`
`delete`	`forge workspace delete <workspaceId> --yes`
`suspend`	`forge workspace suspend <workspaceId> --reason "..."`
`resume`	`forge workspace resume <workspaceId>`
`members`	`forge workspace members <workspaceId> <action> [--role R] [--user U]`
`grants`	`forge workspace grants <workspaceId> <action> [--feature F] [--limit N]`

members actions: list, invite, set-role, remove

grants actions: list, enroll, revoke, mark-used

List workspaces:

forge workspace list --status active --limit 10

Create a workspace:

forge workspace create --name "My Workspace" --tear pro

Suspend a workspace:

forge workspace suspend ws_xxxxx --reason "Abuse detected"

List members:

forge workspace members ws_xxxxx list

Enroll a grant:

forge workspace grants ws_xxxxx enroll --feature ai-agents --limit 1000

Role-based access — member management (invite, set-role, remove) requires appropriate workspace role permissions.
Suspend vs delete — suspend temporarily disables the workspace; delete is permanent.

{auto-injected}