---
title: "PUT /online-evaluation-configs/{onlineEvaluationConfigId}"
method: PUT
path: "/online-evaluation-configs/{onlineEvaluationConfigId}"
---

# PUT /online-evaluation-configs/{onlineEvaluationConfigId}

`PUT /online-evaluation-configs/{onlineEvaluationConfigId}`

Updates an online evaluation configuration's settings, including rules, data sources, evaluators, and execution status. Changes take effect immediately for ongoing evaluations.

## Path parameters

- `onlineEvaluationConfigId` string, required

## Request body

- object
  - `clientToken` string — A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.
  - `description` string, password — The updated description of the online evaluation configuration.
  - `rule` object — The evaluation rule that defines sampling configuration, filtering criteria, and session detection settings for online evaluation.
    - `samplingConfig` object — The sampling configuration that determines what percentage of agent traces to evaluate.
      - `samplingPercentage` number, double, required — The percentage of agent traces to sample for evaluation, ranging from 0.01% to 100%.
    - `filters` Filter[] — The list of filters that determine which agent traces should be included in the evaluation based on trace properties.
      - `key` string, required — The key or field name to filter on within the agent trace data.
      - `operator` 'Equals' | 'NotEquals' | 'GreaterThan' | 'LessThan' | 'GreaterThanOrEqual' | 'LessThanOrEqual' | 'Contains' | 'NotContains', required — The comparison operator to use for filtering.
      - `value` object, required — The value to compare against using the specified operator.
        - `stringValue` string — The string value for text-based filtering.
        - `doubleValue` number, double — The numeric value for numerical filtering and comparisons.
        - `booleanValue` boolean — The boolean value for true/false filtering conditions.
    - `sessionConfig` object — The session configuration that defines timeout settings for detecting when agent sessions are complete and ready for evaluation.
      - `sessionTimeoutMinutes` integer, required — The number of minutes of inactivity after which an agent session is considered complete and ready for evaluation. Default is 15 minutes.
  - `dataSourceConfig` object — The configuration that specifies where to read agent traces for online evaluation.
    - `cloudWatchLogs` object — The CloudWatch logs configuration for reading agent traces from log groups.
      - `logGroupNames` LogGroupName[], required — The list of CloudWatch log group names to monitor for agent traces.
      - `serviceNames` ServiceName[], required — The list of service names to filter traces within the specified log groups. Used to identify relevant agent sessions.
  - `evaluators` EvaluatorReference[] — The updated list of evaluators to apply during online evaluation.
    - `evaluatorId` string — The unique identifier of the evaluator. Can reference builtin evaluators (e.g., Builtin.Helpfulness) or custom evaluators.
  - `insights` Insight[] — The updated list of insight types to run against agent sessions.
    - `insightId` string, required — The unique identifier of the insight to run.
  - `clusteringConfig` object — Configuration for periodic batch evaluation clustering, specifying how often clustering jobs run.
    - `frequencies` ClusteringFrequency[] — The list of frequencies at which clustering batch evaluations are triggered.
  - `evaluationExecutionRoleArn` string — The updated Amazon Resource Name (ARN) of the IAM role used for evaluation execution.
  - `executionStatus` 'ENABLED' | 'DISABLED' — The updated execution status to enable or disable the online evaluation.

## Response `202`

Success

- UpdateOnlineEvaluationConfigResponse
  - `onlineEvaluationConfigArn` string, required — The Amazon Resource Name (ARN) of the updated online evaluation configuration.
  - `onlineEvaluationConfigId` string, required — The unique identifier of the updated online evaluation configuration.
  - `updatedAt` string, date-time, required — The timestamp when the online evaluation configuration was last updated.
  - `status` 'ACTIVE' | 'CREATING' | 'CREATE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'DELETING' | 'ERROR', required — The status of the online evaluation configuration.
  - `executionStatus` 'ENABLED' | 'DISABLED', required — The execution status indicating whether the online evaluation is currently running.
  - `failureReason` string — The reason for failure if the online evaluation configuration update or execution failed.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — ValidationException
- `482` — AccessDeniedException
- `483` — ConflictException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore-control.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore-control/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore-control/versions/0ebde766792b/schema)