= dynamic
:type: input
:status: stable
:categories: ["Utility"]



////
     THIS FILE IS AUTOGENERATED!

     To make changes, edit the corresponding source file under:

     https://github.com/redpanda-data/connect/tree/main/internal/impl/<provider>.

     And:

     https://github.com/redpanda-data/connect/tree/main/cmd/tools/docs_gen/templates/plugin.adoc.tmpl
////

// © 2024 Redpanda Data Inc.


component_type_dropdown::[]


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

```yml
# Config fields, showing default values
input:
  label: ""
  dynamic:
    inputs: {}
    prefix: ""
```

== Fields

=== `inputs`

A map of inputs to statically create.


*Type*: `object`

*Default*: `{}`

=== `prefix`

A path prefix for HTTP endpoints that are registered.


*Type*: `string`

*Default*: `""`

== Endpoints

=== GET `/inputs`

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

=== GET `/inputs/\{id}`

Returns the configuration of an input.

=== POST `/inputs/\{id}`

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

=== DELETE `/inputs/\{id}`

Stops and removes an input.

=== GET `/inputs/\{id}/uptime`

Returns the uptime of an input as a duration string (of the form "72h3m0.5s"), or "stopped" in the case where the input has gracefully terminated.