--- title: MoQ --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # MoQ #### MoQRelays ##### [List relays](https://developers.cloudflare.com/api/python/resources/moq/subresources/relays/methods/list) moq.relays.list(RelayListParams\*\*kwargs) -> SyncSinglePage\[[RelayListResponse]()] GET/accounts/{account\_id}/moq/relays ##### [Get a relay](https://developers.cloudflare.com/api/python/resources/moq/subresources/relays/methods/get) moq.relays.get(strrelay\_id, RelayGetParams\*\*kwargs) -> [RelayGetResponse]() GET/accounts/{account\_id}/moq/relays/{relay\_id} ##### [Create a relay](https://developers.cloudflare.com/api/python/resources/moq/subresources/relays/methods/create) moq.relays.create(RelayCreateParams\*\*kwargs) -> [RelayCreateResponse]() POST/accounts/{account\_id}/moq/relays ##### [Update a relay](https://developers.cloudflare.com/api/python/resources/moq/subresources/relays/methods/update) moq.relays.update(strrelay\_id, RelayUpdateParams\*\*kwargs) -> [RelayUpdateResponse]() PUT/accounts/{account\_id}/moq/relays/{relay\_id} ##### [Delete a relay](https://developers.cloudflare.com/api/python/resources/moq/subresources/relays/methods/delete) moq.relays.delete(strrelay\_id, RelayDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/moq/relays/{relay\_id} ##### ModelsExpand Collapse
class RelayListResponse: … Abbreviated relay for list responses. created: datetime formatdate-time Link to this property modified: datetime formatdate-time Link to this property name: str Link to this property uid: str Link to this property
[Link to this property](<#(resource)%20moq.relays%20%3E%20(model)%20relay_list_response%20%3E%20(schema)>)
class RelayGetResponse: … Full relay details (no tokens).
config: Config
upstreams: Optional\[ConfigUpstreams] Upstreams are external MOQT server publishers that a relay falls back to when it has no local publisher for a requested namespace/track. enabled: Optional\[bool] Link to this property
upstreams: Optional\[List\[ConfigUpstreamsUpstream]] Ordered list of upstream MOQT server publishers. Each entry is an object (not a bare string) so per-upstream configuration can be added in the future without another breaking change. url: str Upstream MOQT server publisher URL. Must be an absolute URL with a host and a scheme the relay can dial: moqt:// (raw QUIC) or https:// (WebTransport). Validated on update (PUT); rejected with 21013. formaturi Link to this property
Link to this property
Link to this property
Link to this property created: datetime formatdate-time Link to this property modified: datetime formatdate-time Link to this property name: str Link to this property uid: str Link to this property status: Optional\[Literal\["connected"]] “connected” when active, omitted otherwise. Link to this property
[Link to this property](<#(resource)%20moq.relays%20%3E%20(model)%20relay_get_response%20%3E%20(schema)>)
class RelayCreateResponse: … Relay with its auto-created default token pair (one full-access \[publish, subscribe] and one \[subscribe]-only), each with its one-time secret, wrapped in the issuers envelope.
config: Config
upstreams: Optional\[ConfigUpstreams] Upstreams are external MOQT server publishers that a relay falls back to when it has no local publisher for a requested namespace/track. enabled: Optional\[bool] Link to this property
upstreams: Optional\[List\[ConfigUpstreamsUpstream]] Ordered list of upstream MOQT server publishers. Each entry is an object (not a bare string) so per-upstream configuration can be added in the future without another breaking change. url: str Upstream MOQT server publisher URL. Must be an absolute URL with a host and a scheme the relay can dial: moqt:// (raw QUIC) or https:// (WebTransport). Validated on update (PUT); rejected with 21013. formaturi Link to this property
Link to this property
Link to this property
Link to this property created: datetime formatdate-time Link to this property
issuers: List\[Issuer] Token collection (discriminated union on type). On create this holds the auto-created default pair, each including its one-time secret.
cloudflare\_tokens: List\[IssuerCloudflareToken] Always present (\[] when empty). created: datetime formatdate-time Link to this property expires: datetime Mandatory; no more than 1 year after created. formatdate-time Link to this property jti: str Token identity and registry key (32 hex chars). Link to this property
operations: List\[Literal\["publish", "subscribe"]] Signed allowlist of what the token may do. V1 coarse roles; the array form extends to fine-grained MoQT message names later without a breaking change. One of the following: "publish" Link to this property "subscribe" Link to this property
Link to this property label: Optional\[str] Optional, customer-set. Link to this property secret: Optional\[str] The signed JWT. Present ONLY in create / auto-create responses (shown once); never returned by list, never stored. Link to this property
Link to this property issuer: Literal\["cloudflare"] Link to this property type: Literal\["cloudflare\_jwt"] Link to this property
Link to this property modified: datetime formatdate-time Link to this property name: str Link to this property uid: str Server-generated unique identifier (32 hex chars). Link to this property
[Link to this property](<#(resource)%20moq.relays%20%3E%20(model)%20relay_create_response%20%3E%20(schema)>)
class RelayUpdateResponse: … Full relay details (no tokens).
config: Config
upstreams: Optional\[ConfigUpstreams] Upstreams are external MOQT server publishers that a relay falls back to when it has no local publisher for a requested namespace/track. enabled: Optional\[bool] Link to this property
upstreams: Optional\[List\[ConfigUpstreamsUpstream]] Ordered list of upstream MOQT server publishers. Each entry is an object (not a bare string) so per-upstream configuration can be added in the future without another breaking change. url: str Upstream MOQT server publisher URL. Must be an absolute URL with a host and a scheme the relay can dial: moqt:// (raw QUIC) or https:// (WebTransport). Validated on update (PUT); rejected with 21013. formaturi Link to this property
Link to this property
Link to this property
Link to this property created: datetime formatdate-time Link to this property modified: datetime formatdate-time Link to this property name: str Link to this property uid: str Link to this property status: Optional\[Literal\["connected"]] “connected” when active, omitted otherwise. Link to this property
[Link to this property](<#(resource)%20moq.relays%20%3E%20(model)%20relay_update_response%20%3E%20(schema)>) #### MoQRelaysTokens ##### [Create a token](https://developers.cloudflare.com/api/python/resources/moq/subresources/relays/subresources/tokens/methods/create) moq.relays.tokens.create(strrelay\_id, TokenCreateParams\*\*kwargs) -> [TokenCreateResponse]() POST/accounts/{account\_id}/moq/relays/{relay\_id}/tokens ##### [List tokens](https://developers.cloudflare.com/api/python/resources/moq/subresources/relays/subresources/tokens/methods/list) moq.relays.tokens.list(strrelay\_id, TokenListParams\*\*kwargs) -> [TokenListResponse]() GET/accounts/{account\_id}/moq/relays/{relay\_id}/tokens ##### [Revoke a token](https://developers.cloudflare.com/api/python/resources/moq/subresources/relays/subresources/tokens/methods/delete) moq.relays.tokens.delete(strjti, TokenDeleteParams\*\*kwargs) -> [TokenDeleteResponse]() DELETE/accounts/{account\_id}/moq/relays/{relay\_id}/tokens/{jti} ##### ModelsExpand Collapse
class TokenCreateResponse: … A relay’s token collection, keyed on issuer type (a discriminated union). V1 ships exactly one arm (cloudflare_jwt). Clients iterate issuers, switch on type, and ignore unknown types — that contract is what makes adding or removing an arm non-breaking.
issuers: List\[Issuer]
cloudflare\_tokens: List\[IssuerCloudflareToken] Always present (\[] when empty). created: datetime formatdate-time Link to this property expires: datetime Mandatory; no more than 1 year after created. formatdate-time Link to this property jti: str Token identity and registry key (32 hex chars). Link to this property
operations: List\[Literal\["publish", "subscribe"]] Signed allowlist of what the token may do. V1 coarse roles; the array form extends to fine-grained MoQT message names later without a breaking change. One of the following: "publish" Link to this property "subscribe" Link to this property
Link to this property label: Optional\[str] Optional, customer-set. Link to this property secret: Optional\[str] The signed JWT. Present ONLY in create / auto-create responses (shown once); never returned by list, never stored. Link to this property
Link to this property issuer: Literal\["cloudflare"] Link to this property type: Literal\["cloudflare\_jwt"] Link to this property
Link to this property
[Link to this property](<#(resource)%20moq.relays.tokens%20%3E%20(model)%20token_create_response%20%3E%20(schema)>)
class TokenListResponse: … A relay’s token collection, keyed on issuer type (a discriminated union). V1 ships exactly one arm (cloudflare_jwt). Clients iterate issuers, switch on type, and ignore unknown types — that contract is what makes adding or removing an arm non-breaking.
issuers: List\[Issuer]
cloudflare\_tokens: List\[IssuerCloudflareToken] Always present (\[] when empty). created: datetime formatdate-time Link to this property expires: datetime Mandatory; no more than 1 year after created. formatdate-time Link to this property jti: str Token identity and registry key (32 hex chars). Link to this property
operations: List\[Literal\["publish", "subscribe"]] Signed allowlist of what the token may do. V1 coarse roles; the array form extends to fine-grained MoQT message names later without a breaking change. One of the following: "publish" Link to this property "subscribe" Link to this property
Link to this property label: Optional\[str] Optional, customer-set. Link to this property secret: Optional\[str] The signed JWT. Present ONLY in create / auto-create responses (shown once); never returned by list, never stored. Link to this property
Link to this property issuer: Literal\["cloudflare"] Link to this property type: Literal\["cloudflare\_jwt"] Link to this property
Link to this property
[Link to this property](<#(resource)%20moq.relays.tokens%20%3E%20(model)%20token_list_response%20%3E%20(schema)>)
class TokenDeleteResponse: …
errors: List\[Error] code: Optional\[int] Link to this property message: Optional\[str] Link to this property
Link to this property
messages: List\[Message] code: Optional\[int] Link to this property message: Optional\[str] Link to this property
Link to this property success: bool Link to this property
[Link to this property](<#(resource)%20moq.relays.tokens%20%3E%20(model)%20token_delete_response%20%3E%20(schema)>)