> This page is for Platform.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://mediakind.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://mediakind.ferndocs.com/_mcp/server.

# Resource states

There are two different “state” concepts, and mixing them up is a common source of confusion:

* `spec.state` is what you set. It only ever has two values: `Stopped` or `Running`. This is the desired state described in Resource types and lifecycle.

* `status.state` is what the platform reports back. It has 13 possible values, because getting from `Stopped` to `Running` (and back) involves several intermediate steps.

## Poll resource state

You can poll just the reported state without reading the full resource object. The state endpoint at `GET /api/v1/projects/{project_name}/live/{resource_type}/{name}/state` returns only `status.state`. This is more efficient for polling loops than fetching the whole resource.

Those 13 values group into four phases: initialising (`""`, `Pending`, `Allocating`, `Allocated`), starting or running (`Starting`, `Started`, `Running`, `Updating`), winding down (`Stopping`, `Stopped`, `Deleting`, `Deleted`), and one error value (`UnableToStart`, meaning the resource failed to reach `Running`).

### Start contribution during startup

For an SRT listener input, prepare the encoder with the source URL and connection settings before requesting startup. Begin contribution as part of the startup procedure and monitor both encoder connection status and `status.state`. A source marked `Active` is in use; verify playback separately to confirm that media is arriving.

See [Monitor live resources](/platform/how-to/live/monitor-live#check-the-current-state) for the reported state values and the rest of the status object.

## What comes next

* Manage live channels and events: create and operate liveChannels and liveEvents.

* Monitor live resources: metrics, monitoring URLs, and the full status object.