---
title: "PUT /api/v1/config/trace-jaeger-remote-sampling-strategies/{slug}"
method: PUT
path: "/api/v1/config/trace-jaeger-remote-sampling-strategies/{slug}"
tags: ["TraceJaegerRemoteSamplingStrategy"]
---

# PUT /api/v1/config/trace-jaeger-remote-sampling-strategies/{slug}

`PUT /api/v1/config/trace-jaeger-remote-sampling-strategies/{slug}`

## Request

- Base URL: `https://docs.chronosphere.io`
- URL: `https://docs.chronosphere.io/api/v1/config/trace-jaeger-remote-sampling-strategies/{slug}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/chronosphere/apis/config-v1-api/docs/api/v1/config/trace-jaeger-remote-sampling-strategies/:slug/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `slug` string, required

## Request body

- ConfigV1UpdateTraceJaegerRemoteSamplingStrategyBody
  - `trace_jaeger_remote_sampling_strategy` Configv1TraceJaegerRemoteSamplingStrategy
    - `slug` string: Unique identifier of the TraceJaegerRemoteSamplingStrategy. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the TraceJaegerRemoteSamplingStrategy is created.
    - `name` string: Required. Name of the TraceJaegerRemoteSamplingStrategy. You can modify this value after the TraceJaegerRemoteSamplingStrategy is created.
    - `created_at` string, date-time: Timestamp of when the TraceJaegerRemoteSamplingStrategy was created. Cannot be set by clients.
    - `updated_at` string, date-time: Timestamp of when the TraceJaegerRemoteSamplingStrategy was last updated. Cannot be set by clients.
    - `service_name` string: The name of the service this sampling strategy applies to. This must match the slug and name fields.
    - `applied_strategy` TraceJaegerRemoteSamplingStrategyAppliedStrategy
      - `probabilistic_strategy` TraceJaegerRemoteSamplingStrategyProbabilisticStrategy
        - `sampling_rate` number, double: Value in the range [0, 1] that defines the probability of sampling any trace.
      - `per_operation_strategies` TraceJaegerRemoteSamplingStrategyPerOperationSamplingStrategies
        - `default_sampling_rate` number, double: Defines the service-wide sampling probability (in the range [0, 1]) when specific operations are not matched.
        - `default_lower_bound_traces_per_second` number, double: Defines a minimum number of traces to send for ANY operation in the service, regardless of matching per operation strategy.
        - `default_upper_bound_traces_per_second` number, double: Defines a maximum number of traces to send for ANY operation in the service, regardless of matching per operation strategy.
        - `per_operation_strategies` PerOperationSamplingStrategiesPerOperationSamplingStrategy[]: Defines explicit operations-specific strategies that take precedence over the default sampling rate.
          - `operation` string: The operation to which this specific strategy should apply.
          - `probabilistic_sampling_strategy` TraceJaegerRemoteSamplingStrategyProbabilisticStrategy
            - `sampling_rate` number, double: Value in the range [0, 1] that defines the probability of sampling any trace.
      - `rate_limiting_strategy` TraceJaegerRemoteSamplingStrategyRateLimitingSamplingStrategy
        - `max_traces_per_second` integer: Maximum number of traces to sample per second.
  - `create_if_missing` boolean: If true, the TraceJaegerRemoteSamplingStrategy will be created if it does not already exist, identified by slug. If false, an error will be returned if the TraceJaegerRemoteSamplingStrategy does not already exist.
  - `dry_run` boolean: If true, the TraceJaegerRemoteSamplingStrategy isn't created or updated, and no response TraceJaegerRemoteSamplingStrategy will be returned. The response will return an error if the given TraceJaegerRemoteSamplingStrategy is invalid.

## Response `200`

A successful response containing the updated TraceJaegerRemoteSamplingStrategy.

- Configv1UpdateTraceJaegerRemoteSamplingStrategyResponse
  - `trace_jaeger_remote_sampling_strategy` Configv1TraceJaegerRemoteSamplingStrategy
    - `slug` string: Unique identifier of the TraceJaegerRemoteSamplingStrategy. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the TraceJaegerRemoteSamplingStrategy is created.
    - `name` string: Required. Name of the TraceJaegerRemoteSamplingStrategy. You can modify this value after the TraceJaegerRemoteSamplingStrategy is created.
    - `created_at` string, date-time: Timestamp of when the TraceJaegerRemoteSamplingStrategy was created. Cannot be set by clients.
    - `updated_at` string, date-time: Timestamp of when the TraceJaegerRemoteSamplingStrategy was last updated. Cannot be set by clients.
    - `service_name` string: The name of the service this sampling strategy applies to. This must match the slug and name fields.
    - `applied_strategy` TraceJaegerRemoteSamplingStrategyAppliedStrategy
      - `probabilistic_strategy` TraceJaegerRemoteSamplingStrategyProbabilisticStrategy
        - `sampling_rate` number, double: Value in the range [0, 1] that defines the probability of sampling any trace.
      - `per_operation_strategies` TraceJaegerRemoteSamplingStrategyPerOperationSamplingStrategies
        - `default_sampling_rate` number, double: Defines the service-wide sampling probability (in the range [0, 1]) when specific operations are not matched.
        - `default_lower_bound_traces_per_second` number, double: Defines a minimum number of traces to send for ANY operation in the service, regardless of matching per operation strategy.
        - `default_upper_bound_traces_per_second` number, double: Defines a maximum number of traces to send for ANY operation in the service, regardless of matching per operation strategy.
        - `per_operation_strategies` PerOperationSamplingStrategiesPerOperationSamplingStrategy[]: Defines explicit operations-specific strategies that take precedence over the default sampling rate.
          - `operation` string: The operation to which this specific strategy should apply.
          - `probabilistic_sampling_strategy` TraceJaegerRemoteSamplingStrategyProbabilisticStrategy
            - `sampling_rate` number, double: Value in the range [0, 1] that defines the probability of sampling any trace.
      - `rate_limiting_strategy` TraceJaegerRemoteSamplingStrategyRateLimitingSamplingStrategy
        - `max_traces_per_second` integer: Maximum number of traces to sample per second.

## Other responses

- `400`: Cannot update the TraceJaegerRemoteSamplingStrategy because the request is invalid.
- `404`: Cannot update the TraceJaegerRemoteSamplingStrategy because the slug does not exist.
- `409`: Cannot update the TraceJaegerRemoteSamplingStrategy because there is a conflict with an existing TraceJaegerRemoteSamplingStrategy.
- `500`: An unexpected error response.
- `default`: An undefined error response.

---

[API](https://skmtc.dev/chronosphere/apis/config-v1-api.md) - [All operations](https://skmtc.dev/chronosphere/apis/config-v1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chronosphere/apis/config-v1-api/revisions/530951bd2ccf?raw)