Preflight Checks
What Borker validates before running a workflow, and how to fix each issue.
Before any workflow runs, Borker performs a preflight check to catch configuration issues early. There are two severity levels:
- 🔴 Blocking: The workflow will not run until this is fixed
- 🟡 Warning: The workflow will run, but results may be degraded
Blocking checks (🔴)
These prevent the workflow from running at all.
| Check | What it means | How to fix |
|---|---|---|
| Anthropic API key missing | No key configured; Claude can't be called | Settings → Workspace → API Keys → Add Anthropic key |
| No calendar slots for today | No slots configured for today's day of week | Settings → Scheduling → add a slot for today's day |
| Post limit reached | You've hit your plan's monthly post cap (30 on Starter) | Upgrade to Pro, or wait for the monthly reset |
If you see "Post limit reached" and you're on Starter, upgrading to Pro removes the monthly cap entirely.
Warning checks (🟡)
These let the workflow proceed but indicate configuration gaps that will affect output quality.
| Check | What it means | How to fix |
|---|---|---|
| Postiz API key missing | Content will generate but can't be scheduled to Postiz | Settings → Workspace → API Keys → Add Postiz key |
| No brand voice configured | Content will generate but with generic, unconfigured voice | Settings → Brand → fill in brand voice fields |
| No topics in pool | Nothing for the Decision Engine to select | Settings → Topics → add at least one topic |
| No prompt templates | Will use built-in defaults | Settings → Prompts → optionally add custom templates |
When preflight runs
Preflight runs automatically when you:
- Click Run on any workflow card
- Hit the preflight API endpoint directly (
GET /api/workflows/preflight)
The preflight panel in the UI always shows the current state of your configuration, even when you're not about to run a workflow. Use it as a health check after initial setup.
Fixing preflight issues
The most common setup sequence for a new workspace:
Quick setup checklist:
- Add Anthropic API key (blocking if missing)
- Add Postiz API key (warning if missing, but you need it to publish)
- Configure at least one calendar slot (blocking if missing)
- Add at least one topic (warning if missing)
- Configure brand voice (warning if missing)
See API Keys, Scheduling, and Topics for setup instructions.