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

# Troubleshooting

> Common issues and how to resolve them.

## Generation Issues

<AccordionGroup>
  <Accordion title="Generation is stuck or taking too long">
    Generation typically completes in 90 seconds to 4 minutes. If the progress indicator has been running for more than 8 minutes:

    * Refresh the page and check your Content Library — the generation may have completed in the background
    * Check the platform status page at [writerzroom.com/status](https://writerzroom.com/status) for any active incidents
    * If the issue persists, contact support with your request ID when available
  </Accordion>

  <Accordion title="Generation completed but the output is low quality">
    This is almost always an input issue. Review:

    * Is the topic specific enough? Vague topics produce vague output.
    * Is the audience defined precisely? "Developers" is less useful than "senior backend engineers evaluating vector database options."
    * Is the style profile appropriate for the template and audience?
    * Did you provide key points? They help shape the structure and direction of the draft.

    If inputs are solid and quality is still poor, try section regeneration on the weak sections before re-running the full generation.
  </Accordion>

  <Accordion title="Generation failed with an error">
    Failed generations **do not count against your monthly limit**. If a generation fails:

    * Review your input fields. Missing required fields or malformed values can cause failures.
    * Try again. Transient failures are rare but possible during high-traffic periods.
    * If the same generation fails repeatedly, contact [support@writerzroom.com](mailto:support@writerzroom.com) with the request ID
  </Accordion>
</AccordionGroup>

## Publishing Issues

<AccordionGroup>
  <Accordion title="Publishing returns a connection error">
    Your platform credentials have likely expired or been revoked. Go to **Settings → Publishing**, select the affected platform, and re-authenticate.
  </Accordion>

  <Accordion title="Content publishes but doesn't appear on the platform">
    This is usually a platform-side delay. Some platforms can take time to index new posts. Check the platform directly. If the post does not appear after 5 minutes, check the post status. It may have been saved as a draft rather than published.
  </Accordion>

  <Accordion title="Beehiiv newsletter isn't sending">
    WriterzRoom creates the newsletter issue in Beehiiv but does not trigger the send. Log in to Beehiiv and send the issue from there. WriterzRoom is not able to initiate Beehiiv sends.
  </Accordion>
</AccordionGroup>

## Account and Billing Issues

<AccordionGroup>
  <Accordion title="My generation limit reset but I'm still seeing the old count">
    Dashboard usage counts can take up to 15 minutes to refresh after a billing cycle reset. Hard refresh your browser (`Ctrl+Shift+R` / `Cmd+Shift+R`) and check again.
  </Accordion>

  <Accordion title="I was charged but my plan didn't upgrade">
    Contact support at **[support@writerzroom.com](mailto:support@writerzroom.com)** with your account email, the date of the charge, and any billing confirmation you received.
  </Accordion>
</AccordionGroup>

## API Issues

<AccordionGroup>
  <Accordion title="POST /generate returns 401">
    Your API key is missing, malformed, or expired. Confirm you're sending `Authorization: Bearer YOUR_API_KEY` in the request header. If the key looks correct, regenerate it in **Settings → API Access**.
  </Accordion>

  <Accordion title="POST /generate returns 429">
    You've hit the rate limit. Reduce request frequency and implement exponential backoff in your client.
  </Accordion>

  <Accordion title="Generation status never reaches 'completed'">
    Poll the status endpoint every 5–10 seconds. If status remains `processing` beyond the expected processing window, record the `request_id` and contact support.
  </Accordion>
</AccordionGroup>