Skip to content
Cloudflare API
Start here
API Reference

MoQ

MoQRelays

resource cloudflare_moq_relay

required Expand Collapse
account_id: String

Cloudflare account identifier.

name: String

Human-readable name for the relay.

optional Expand Collapse
config?: Attributes

origin_fallback and lingering_subscribe are mutually exclusive.

lingering_subscribe?: Attributes
enabled?: Bool
max_timeout_ms?: Int64

Relay-level ceiling on lingering subscribe timeout (ms). Default 30000.

origin_fallback?: Attributes
enabled?: Bool
origins?: List[Attributes]

Ordered list of upstream origin relays. Each entry is an object (not a bare string) so per-origin configuration can be added in the future without another breaking change.

url?: String

Upstream origin relay URL.

computed Expand Collapse
id: String

Server-generated unique identifier (32 hex chars).

uid: String

Server-generated unique identifier (32 hex chars).

created: Time
modified: Time
status: String

“connected” when active, omitted otherwise.

token_publish_subscribe: String

Full access token (publish + subscribe). Treat as sensitive.

token_subscribe: String

Subscribe-only token. Treat as sensitive.

cloudflare_moq_relay

resource "cloudflare_moq_relay" "example_moq_relay" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  name = "Production Live Stream"
}

data cloudflare_moq_relay

required Expand Collapse
account_id: String

Cloudflare account identifier.

optional Expand Collapse
relay_id?: String
filter?: Attributes
asc?: Bool

Sort order by created. When true, results are returned oldest-first (ascending); otherwise newest-first (descending, the default).

created_after?: Time

Cursor for pagination. Returns relays created strictly after this RFC 3339 timestamp (typically the created value of the last item on the current page, to fetch the next page).

created_before?: Time

Cursor for pagination. Returns relays created strictly before this RFC 3339 timestamp (typically the created value of the first item on the current page, to fetch the previous page).

per_page?: Int64

Maximum number of relays to return per page.

computed Expand Collapse
id: String
created: Time
modified: Time
name: String
status: String

“connected” when active, omitted otherwise.

uid: String
config: Attributes

origin_fallback and lingering_subscribe are mutually exclusive.

lingering_subscribe: Attributes
enabled: Bool
max_timeout_ms: Int64

Relay-level ceiling on lingering subscribe timeout (ms). Default 30000.

origin_fallback: Attributes
enabled: Bool
origins: List[Attributes]

Ordered list of upstream origin relays. Each entry is an object (not a bare string) so per-origin configuration can be added in the future without another breaking change.

url: String

Upstream origin relay URL.

cloudflare_moq_relay

data "cloudflare_moq_relay" "example_moq_relay" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  relay_id = "a1b2c3d4e5f67890a1b2c3d4e5f67890"
}

data cloudflare_moq_relays

required Expand Collapse
account_id: String

Cloudflare account identifier.

optional Expand Collapse
created_after?: Time

Cursor for pagination. Returns relays created strictly after this RFC 3339 timestamp (typically the created value of the last item on the current page, to fetch the next page).

created_before?: Time

Cursor for pagination. Returns relays created strictly before this RFC 3339 timestamp (typically the created value of the first item on the current page, to fetch the previous page).

per_page?: Int64

Maximum number of relays to return per page.

asc?: Bool

Sort order by created. When true, results are returned oldest-first (ascending); otherwise newest-first (descending, the default).

max_items?: Int64

Max items to fetch, default: 1000

computed Expand Collapse
result: List[Attributes]

The items returned by the data source

id: String
created: Time
modified: Time
name: String
uid: String

cloudflare_moq_relays

data "cloudflare_moq_relays" "example_moq_relays" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  created_after = "2026-03-27T15:00:00Z"
  created_before = "2026-03-27T15:00:00Z"
  per_page = 50
}