@spec analytics(FoPost.Client.t(), String.t()) ::
  {:ok, FoPost.WorkspaceAnalytics.t()} | {:error, FoPost.Error.t()}

A workspace's follower and post totals.

Same as analytics/2, but raises FoPost.Error.

@spec create(
  FoPost.Client.t(),
  keyword()
) :: {:ok, FoPost.Workspace.t()} | {:error, FoPost.Error.t()}

Adds a workspace.

Required: :name, :slug. Optional: :type, :logo, :website, :timezone, :country, :description, :language.

Plans cap how many workspaces an account may have, so this answers 402 once the limit is reached.

Same as create/2, but raises FoPost.Error.

@spec delete(FoPost.Client.t(), String.t()) ::
  {:ok, FoPost.Message.t()} | {:error, FoPost.Error.t()}

Removes a workspace and everything scoped to it.

Same as delete/2, but raises FoPost.Error.

@spec get(FoPost.Client.t(), String.t()) ::
  {:ok, FoPost.Workspace.t()} | {:error, FoPost.Error.t()}

One workspace, with its connected accounts.

Same as get/2, but raises FoPost.Error.

@spec list(FoPost.Client.t()) ::
  {:ok, [FoPost.Workspace.t()]} | {:error, FoPost.Error.t()}

Every workspace the key can reach.

Same as list/1, but raises FoPost.Error.

@spec update(FoPost.Client.t(), String.t(), keyword()) ::
  {:ok, FoPost.Workspace.t()} | {:error, FoPost.Error.t()}

Edits a workspace. Only the keys you pass are sent.

Beyond the create fields: :require_approval, :ai_alt_text_enabled, :brand_color.

Same as update/3, but raises FoPost.Error.