
Castwyn
Help CenterCommon errors
Every error message Castwyn shows, what it means, and the fix. Copy the exact text from the app and find it below.
“No OpenAI, Anthropic, xAI (Grok), or DeepSeek key saved. Add one on the Keys page.”
Where: Compose, Voice preview, API
Why: This message is only for generation. Writing, scheduling, and publishing your own text does not need an AI key. Generation runs on your own AI key, and none is saved for that provider.
Fix: Choose Write my own on Compose, or send the text through the API or MCP without adapt. To generate, go to AI keys and enter an OpenAI, Anthropic, xAI (Grok), or DeepSeek API key.
“That key was not accepted”
Where: Compose, week generation, API, AI keys
Why: Your saved AI key is invalid, revoked, or expired. OpenAI and Anthropic say they rejected the API key. xAI and DeepSeek say that key was not accepted.
Fix: Create a fresh key in your OpenAI, Anthropic, xAI (Grok), or DeepSeek dashboard and re-save it on the AI keys page.
“OpenAI, Anthropic, xAI (Grok), or DeepSeek rate limit”
Where: Compose, week generation
Why: Your AI provider is rate-limiting you or your credit balance ran out.
Fix: Check your provider's billing page. Week generation runs in small batches to stay under limits, but an empty balance stops everything.
“A card is required to start the 7-day trial. You will not be charged until it ends. Start it from the dashboard. You will get an email a few days before any charge, and you can cancel anytime before then.”
Where: Any create/generate/publish action
Why: Your trial or subscription is not active, and you have not used a trial yet.
Fix: Open the Dashboard and start the 7-day trial with a card, or open Account and billing if a payment failed. Your posts and keys stay either way.
“Subscribe from the dashboard to unlock Castwyn. The card is charged today, then the plan renews monthly until you cancel. You will get an email a few days before a later charge. Cancel anytime from Account and billing.”
Where: Any create/generate/publish action after a trial
Why: Your subscription is not active. A second checkout charges the card today.
Fix: Open the Dashboard and subscribe, or open Account and billing if a payment failed. Your posts and keys stay either way.
“Account is not connected.”
Where: Publish now, scheduled publishing
Why: The post targets a network you haven't connected (or whose connection was removed).
Fix: Open the network under Networks in the sidebar and connect it, then retry the post.
“Threads connection expired. Reconnect your Threads account.”
Where: Threads publishing
Why: Threads tokens last about 60 days. Castwyn auto-refreshes them near expiry, but a long-idle connection can lapse.
Fix: Open Networks → Threads and reconnect. Takes ten seconds.
“Bluesky connection is incomplete. Reconnect.”
Where: Bluesky publishing
Why: The stored Bluesky app-password session is missing pieces (usually after a password change on Bluesky's side).
Fix: Open Networks → Bluesky and reconnect with a fresh app password.
“This network does not publish from Castwyn. Use Copy and open, then mark it posted.”
Where: Queue, Publish now
Why: This network does not publish from Castwyn. That is not a plan limit. Substack has no public API.
Fix: Use Copy and open. Your post is copied and the network opens. Then mark it posted.
“Already published.”
Where: Queue
Why: You tried to publish or reschedule a post that already went out.
Fix: Nothing to do. Duplicate publishes are blocked on purpose. Generate a fresh post if you want to say it again.
“This post is already being published.”
Where: Queue, API
Why: Two publish attempts raced (double-click, or the scheduler picked it up at the same moment).
Fix: Wait a few seconds and refresh. The first attempt finishes and the post shows as published.
“That time is in the past.”
Where: Scheduling
Why: The schedule time you picked is earlier than now (timezone mix-ups are the usual culprit).
Fix: Pick a future time. The picker uses your device's local timezone.
“Missing or invalid API token. Send it as: Authorization: Bearer cwn_…”
Where: REST API, MCP
Why: The request has no token, a typo'd token, or a revoked one.
Fix: Create a token on the API & MCP page and send it exactly as shown in the examples there. Tokens are shown once. If lost, revoke and create a new one.
“Post not found.”
Where: REST API, MCP
Why: The post id doesn't exist or belongs to a different account.
Fix: List your posts first (GET /api/v1/posts or the castwyn_list_posts tool) and use an id from the response.
Error not listed, or the fix didn’t work? Send it to support with the exact text.