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

# Workspaces and accounts

> Select tenants, discover connected accounts, and inspect provider schemas.

## List Workspaces

```bash theme={null}
postlybee workspaces:list
```

The result contains only Workspaces allowed by the Token and current OWNER/MANAGER membership.

```json theme={null}
[
  {
    "id": "4cb8c6af-7111-4e5d-a7cd-846c9293d4c1",
    "name": "PostlyBee",
    "type": "PERSONAL",
    "timezone": "Asia/Shanghai"
  }
]
```

Select a Workspace globally:

```bash theme={null}
export POSTLYBEE_WORKSPACE_ID="4cb8c6af-7111-4e5d-a7cd-846c9293d4c1"
```

Or for one command:

```bash theme={null}
postlybee accounts:list --workspace 4cb8c6af-7111-4e5d-a7cd-846c9293d4c1
```

## List connected accounts

```bash theme={null}
postlybee accounts:list
```

Use the returned account `id` for posting, analytics, settings, and posting-slot commands. Provider names and profile URLs are not account IDs.

## Connect an account

```bash theme={null}
postlybee accounts:connect x
postlybee accounts:connect mastodon --external-url https://social.example.com
```

The CLI returns an OAuth URL as JSON. Open it in a browser to authorize the provider. Reconnect an existing provider identity with `--refresh <accountId>`.

## Provider settings

```bash theme={null}
postlybee accounts:settings ACCOUNT_ID
```

The response includes platform rules, maximum content length, provider settings schema, and discovery tools.

Trigger one of the advertised tools:

```bash theme={null}
postlybee accounts:trigger ACCOUNT_ID getBoards \
  --data '{"query":"product"}'
```

Discovery tools can return Pinterest boards, Reddit flairs, YouTube playlists, LinkedIn companies, or other provider-specific data.

## Delete an account

```bash theme={null}
postlybee accounts:delete ACCOUNT_ID
```

This disconnects the account, stops its refresh workflow, and deletes its pending posts. The command intentionally has no interactive confirmation so automated scripts remain deterministic; confirm the target ID in your own workflow before executing it.