> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orca.0-9.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> Manage personal, domain, external, and admin settings with `oi settings`.

`oi settings` exposes the same configuration surfaces as the OpenIndex web UI. It is designed for **human-owned credentials** — Personal Access Tokens with `read_write` or `admin` scope. Workflow agent run tokens are intentionally rejected for all `oi settings ...` commands.

<Warning>
  Do not use agent run tokens with `oi settings`. These commands require a PAT issued to a human user.
</Warning>

Because the settings surface is broad, the best way to discover available sub-commands is with `--help`:

```bash theme={null}
oi settings --help
oi settings personal --help
oi settings domain --help
oi settings external --help
oi settings admin --help
```

## Personal settings

Manage your profile, access tokens, calendar sources, and workflow preferences.

```bash theme={null}
oi settings personal profile get
oi settings personal profile update --display-name "Matt" --timezone-mode manual --timezone Australia/Perth
oi settings personal profile avatar upload --file ./avatar.png
oi settings personal tokens list
oi settings personal tokens create --name "local cli" --scope read_write
oi settings personal calendars list
oi settings personal calendars create --display-name "Personal" --source-url "https://example.com/calendar.ics"
oi settings personal workflows list
oi settings personal workflows fields list OPS
oi settings personal workflows providers list
```

## Domain settings

Manage domains, their workflows, members, and lifecycle.

```bash theme={null}
oi settings domain list
oi settings domain get OPS
oi settings domain create --key OPS --name "Operations"
oi settings domain workflows list --domain OPS
oi settings domain workflows get TRIAGE --domain OPS
oi settings domain workflows fields list TRIAGE --domain OPS
oi settings domain members list --domain OPS
oi settings domain delete-preview OPS
```

<Note>
  `delete-preview` shows what would be removed before you commit to deleting a domain. Review the output carefully before proceeding with a destructive operation.
</Note>

## External settings

Manage mailboxes, email routing rules, email provider configuration, domains, and webhooks.

```bash theme={null}
oi settings external mailboxes list
oi settings external mailboxes routing-rules list support@company.com
oi settings external email provider get
oi settings external email domains list
oi settings external email domains provision --name support.example.com
oi settings external email webhooks list
```

## Admin settings

Instance-level administration: branding, invites, admin users, user management, and AI provider configuration.

<Warning>
  Admin commands require a PAT with `admin` scope. Using a `read_write`-scoped token will result in a permission error.
</Warning>

```bash theme={null}
oi settings admin instance get
oi settings admin instance update --app-display-name "OpenIndex"
oi settings admin instance branding upload --file ./logo.png
oi settings admin invites send --email new.user@example.com
oi settings admin instance-admins list
oi settings admin users list --search matt
oi settings admin ai-providers list
oi settings admin ai-providers test openclaw-primary
```