FoPost logoFoPost Docs

Accounts and Workspaces

Inspect connected accounts, their health, and your workspaces.

fopost accounts reads connected social accounts; fopost workspaces manages the workspaces they live in. Connecting an account itself happens in the dashboard: a network's authorisation screen needs a browser.

Accounts

fopost accounts list                    # every account in the resolved workspace
fopost accounts get acc_9f2c4a7b

list uses the workspace from --workspace or your saved default; with neither, it returns every account the key can reach.

Health

fopost accounts health                  # workspace-wide summary
fopost accounts health acc_9f2c4a7b     # one account
fopost accounts health acc_9f2c4a7b --refresh   # re-check live, not the stored result

The summary lists each account's stored health plus totals: healthy, degraded, expired, revoked, unknown. --refresh applies to the single-account form only.

# Every account whose credentials have gone stale.
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id'

Validate and refresh

fopost accounts validate acc_9f2c4a7b   # check the stored credentials against the platform
fopost accounts refresh acc_9f2c4a7b    # renew the OAuth token, prints the new expiry

validate exits non-zero when the credentials are no longer valid (after printing the result), so it slots straight into a monitoring script. Reconnecting a dead account happens in the dashboard.

Workspaces

fopost workspaces list                  # also: fopost ws list
fopost workspaces get ws_123
fopost workspaces create --name "Acme Brand" --slug acme-brand \
  --type BRAND --timezone Europe/Berlin

create requires --name and --slug; --type, --timezone, --language, --website, and --description are optional. get shows the workspace's fields and its connected accounts in one view.

# Grab a workspace id for the next command.
fopost ws list --json | jq -r '.[0].id'

Next

Connecting AccountsConnect a network, keep it healthy, and reconnect when a token expires.Accounts APIList connected social accounts, check their health, and refresh credentials.Workspaces APIWorkspaces, labels, and how isolation works across them.
Related documentation
  • CLI

    Schedule, publish, and inspect FoPost content from your terminal, as a single static binary.

  • Posts

    Create, schedule, publish, and inspect posts from the terminal.

  • Media and Labels

    Manage library assets and campaign labels from the terminal.

  • Analytics

    Read cross-account performance numbers without leaving the terminal.

  • Automations and Webhooks

    Trigger automations and manage webhook subscriptions from the terminal.

  • Scripting

    JSON output, exit codes, and shell completion for automation.

Was this helpful?

On this page

Accounts
Health
Validate and refresh
Workspaces
Next