# okibi workspaces

> List, create, rename, and manage workspaces

Generated from okibi 0.2.4. Every command also accepts `--agent`; see [Agent and CI mode](https://okibi.ai/docs/cli/agent-mode.md).

## okibi workspaces

List, create, rename, and manage workspaces

```sh
okibi workspaces [flags]
okibi workspaces [command]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces create

Create a workspace (plan allowances apply)

```sh
okibi workspaces create <slug> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--name` | string |  | workspace display name (default: slug) |

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces delete

delete a workspace (owner and unrestricted key required)

```sh
okibi workspaces delete <slug> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--yes` | bool |  | confirm permanent removal of workspace content |

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces invitations

List pending invitations, invite members, and cancel invitations

```sh
okibi workspaces invitations [flags]
okibi workspaces invitations [command]
```

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces invitations cancel

Cancel a pending invitation

```sh
okibi workspaces invitations cancel <invitation-id> [flags]
```

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces invitations invite

Send a workspace invitation

```sh
okibi workspaces invitations invite <email> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--role` | string | builder | invited role: admin, builder, or tester |

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces members

List members and manage workspace roles

```sh
okibi workspaces members [flags]
okibi workspaces members [command]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--limit` | int | 100 | maximum members to return (1–1000) |
| `--offset` | int |  | number of members to skip |

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces members remove

Remove a workspace member

```sh
okibi workspaces members remove <member-id> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--yes` | bool |  | confirm removal of this member |

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces members role

Change a member's role

```sh
okibi workspaces members role <member-id> <admin|builder|tester> [flags]
```

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces rename

Change the display name, preserving the workspace URL

```sh
okibi workspaces rename <slug> <name> [flags]
```

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces reset

reset a workspace (owner and unrestricted key required)

```sh
okibi workspaces reset <slug> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--yes` | bool |  | confirm permanent removal of workspace content |

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi workspaces switch

Set the workspace commands target by default on this machine. --workspace and OKIBI_WORKSPACE still override it per command. The default belongs to the key stored by `okibi auth login` and to the server it was chosen on; a key passed through OKIBI_API_KEY keeps targeting its own home workspace.

```sh
okibi workspaces switch <slug> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |

Inherited flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--json` | bool |  | emit JSON |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace) |