Connect
Self-Managed Only

dynamic

A special broker type where the outputs are identified by unique labels and can be created, changed and removed during runtime via a REST API.

  • Common

  • Advanced

output:
  label: ""
  dynamic:
    outputs: {}
    prefix: ""
output:
  label: ""
  dynamic:
    outputs: {}
    prefix: ""
    bind_http: false

The broker pattern used is always fan_out, meaning each message will be delivered to each dynamic output.

Fields

bind_http

Whether to register the REST HTTP endpoints (/outputs, /outputs/{id}, and so on) for creating, updating and removing outputs at runtime. These endpoints are served on the service-wide HTTP server and accept output configuration over HTTP, so they are disabled by default. Enable them only when that server is secured appropriately, for example bound to a trusted interface or protected with http.basic_auth.

Requires version 4.111.0 or later.

Type: bool

Default: false

outputs

A map of outputs to statically create.

Type: object<output>

Default: {}

prefix

A path prefix for HTTP endpoints that are registered.

Type: string

Default: ""

Endpoints

GET /outputs

Returns a JSON object detailing all dynamic outputs, providing information such as their current uptime and configuration.

GET /outputs/{id}

Returns the configuration of an output.

POST /outputs/{id}

Creates or updates an output with a configuration provided in the request body (in YAML or JSON format).

DELETE /outputs/{id}

Stops and removes an output.

GET /outputs/{id}/uptime

Returns the uptime of an output as a duration string (of the form "72h3m0.5s").