> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alpic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# telemetry destinations update

> Verify and update an OTLP destination

Verifies the resulting configuration with a test payload, then updates selected fields on a saved OTLP destination. Omitted fields remain unchanged. A paid plan is required.

## Usage

```bash theme={null}
alpic telemetry destinations update \
  --destination-id <destinationId> \
  --endpoint https://otlp.example.com/v1/traces
```

## Extended Usage

Enable or disable intentional-request filtering for a trace destination:

```bash theme={null}
alpic telemetry destinations update --destination-id <destinationId> --intentional-only
alpic telemetry destinations update --destination-id <destinationId> --no-intentional-only
```

Replace all headers or remove them:

```bash theme={null}
alpic telemetry destinations update \
  --destination-id <destinationId> \
  --header X-Tenant=acme \
  --secret-header "Authorization=Bearer token"

alpic telemetry destinations update --destination-id <destinationId> --clear-headers
```

<Note>
  Providing any header flag replaces the complete header set. Omit all header flags to preserve existing headers. A
  stored secret header is bound to the endpoint it was saved against: changing `--endpoint` requires passing the secret
  header again.
</Note>

## Options

| Flag | Description | Default |
| - | - | - |
| `--environment-id` | Select an environment by ID | |
| `--environment-name` | Select an environment by name | |
| `--project-id` | Provide the project context by ID | |
| `--project-name` | Provide the project context by name | |
| `--destination-id` | ID of the telemetry destination | Required |
| `--endpoint` | Complete OTLP signal endpoint | |
| `--protocol` | `http/protobuf` or `http/json` | |
| `--header` | Replace headers with a visible header. Repeatable. | |
| `--secret-header` | Replace headers with a secret header. Repeatable. | |
| `--clear-headers` | Remove all headers | `false` |
| `--intentional-only` | Export only intentional request traces | |
| `--no-intentional-only` | Export all request traces | |
| `--json` | Print the unmodified API response as JSON | `false` |
| `--non-interactive` | Skip interactive prompts | |

<Tip>When the current directory is linked to an environment, the environment and project flags can be omitted.</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.