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

# Common Setup Issues

> Fast answers for stream validation, conditions, jobs, and delivery modes

## Stream Setup

### Why does stream validation fail?

Common causes are:

* URL is not currently live (`NOT_LIVESTREAM`, `STREAM_OFFLINE`)
* URL format is invalid (`INVALID_URL`)
* Stream cannot be fetched (`STREAM_FETCH_FAILED`)

Start with [Validate Stream](/api-reference/streams-validate), then see [Debugging Playbook](/guides/debugging).

### Which stream types are supported?

* YouTube Live
* Twitch live channels
* RTSP and RTSPS sources

## Conditions

### Why does my condition never trigger?

Most misses come from vague wording. Use strict yes/no language and visible criteria.

Use this loop:

1. Test with [Check Once](/api-reference/check-once)
2. Refine condition text
3. Re-run monitor job

Reference: [Writing Reliable Conditions](/guides/writing-conditions)

## Jobs

### Why did my job stop?

Jobs can end because the condition was met, max duration was reached, the job was cancelled, or an error occurred.

Inspect current and final state with [Get Job Details](/api-reference/jobs-get).

### How do I continue coverage after a job ends?

Create a new monitor or digest job when the previous job reaches terminal state.

Implementation patterns:

* [Use Polling](/guides/poll-jobs)
* [Use Webhooks](/guides/webhooks)

### How do I cancel a running job?

Use [Cancel Job](/api-reference/jobs-delete) with the `job_id`.

## Delivery Modes

### Should I use polling, webhooks, or SSE?

* Polling: simplest for backend scripts.
* Webhooks: best for event-driven systems.
* SSE: best for real-time UI streaming.

Decision guide: [Choose Your Workflow](/start-here/choose-workflow)

## Reliability

### What is the fastest troubleshooting loop?

1. [Validate Stream](/api-reference/streams-validate)
2. [Check Once](/api-reference/check-once)
3. [Get Job Details](/api-reference/jobs-get)
4. [Debugging Playbook](/guides/debugging)

Also see: [Debugging Playbook](/guides/debugging)

## Next Steps

* Core behavior: [Monitoring Modes and Delivery Patterns](/core-concepts/how-trio-works)
* Production guides: [Guides](/guides/webhooks)
* Endpoint details: [API Reference](/api-reference/live-monitor)