# manage-runners metrics update

> Update a Metrics connection; endpoint or header changes recreate the VMs of active runners that use it

Source: https://managerunners.com/docs/cli/reference/metrics-update/

| | |
| --- | --- |
| Required scopes | `runners:read`, `runners:write` |
| Required flags | none |
| Changes state | yes |
| Destructive | no |
| Paid resource effect | `recreate` |
| Confirmation | `paid_resource` |
| Non-interactive use | supported |

> This command may delete and recreate an active runner's VM. Read [confirmations](https://managerunners.com/docs/cli/agents/#confirmations) before running it non-interactively.

## Usage

```text
Update a Metrics connection; endpoint or header changes recreate the VMs of active runners that use it

Usage:
  manage-runners metrics update [flags]

Flags:
      --endpoint string          OTLP/HTTP base endpoint (https://...); /v1/metrics is appended
      --header stringArray       send header NAME, keeping its stored value or prompting for it; repeatable
      --header-env stringArray   send header NAME=VAR with the value of environment variable VAR; repeatable
      --header-stdin string      send header NAME with the value read from stdin
      --id string                connection id
      --name string              connection name
      --new-name string          rename the connection
      --no-headers               remove all headers
      --profile string           configuration profile
      --yes                      confirm recreating the VMs of active runners that use the connection; required when the endpoint or headers change
```

Every command also accepts the [global flags](https://managerunners.com/docs/cli/reference/#global-flags). For machine-readable help, run `manage-runners help metrics update --output json`.
