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

# Troubleshooting

> Resolve common channel, feed, history, account, and API issues.

<AccordionGroup>
  <Accordion title="I added a channel, but the feed is empty">
    A new channel can take about 10 minutes to complete its first discovery pass.
    Monitor YT only discovers public long-form uploads, and events are created from
    recorded activity rather than backfilled from all of YouTube.

    Confirm that the channel appears under **Channels**, wait a few minutes, then
    use **Refresh feed**.
  </Accordion>

  <Accordion title="A Short, livestream, or members-only upload is missing">
    New upload discovery uses YouTube's public long-form channel feed. Shorts,
    livestreams, private videos, and members-only uploads are excluded.
  </Accordion>

  <Accordion title="A title or thumbnail changed before Monitor YT showed it">
    Events are periodic public observations, not webhook notifications from
    YouTube. The delay depends on video age, the data surface, and whether YouTube
    returned usable data. See [Detection and data freshness](/detection-and-freshness).
  </Accordion>

  <Accordion title="The video chart is locked or has too few points">
    Growth charts require Pro. A new video also needs at least two usable public
    samples before Monitor YT can draw a trend line. The chart fills in as scheduled
    collection continues.
  </Accordion>

  <Accordion title="Refresh video failed">
    YouTube may have made the video private or unavailable, or a public fetch may
    have failed temporarily. Wait and try again. Repeated manual requests can also
    be rate limited.
  </Accordion>

  <Accordion title="My API key returns 401">
    Check that the header is exactly `Authorization: Bearer myt_…`. A missing,
    malformed, revoked, or regenerated key returns `401 unauthorized`.
  </Accordion>

  <Accordion title="My API key returns 403">
    A valid key on a Free account returns `403 upgrade_required`. Upgrade the
    account under Billing before calling authenticated endpoints.
  </Accordion>

  <Accordion title="I cannot delete my account">
    Active Pro subscriptions must be canceled from Billing first. After Stripe has
    processed the cancellation and the account is Free, return to Settings.
  </Accordion>
</AccordionGroup>

Still stuck? Contact [support@monitoryt.com](mailto:support@monitoryt.com).