---
title: "POST /evaluators"
method: POST
path: "/evaluators"
---

# POST /evaluators

`POST /evaluators`

Lists all available evaluators, including both builtin evaluators provided by the service and custom evaluators created by the user.

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListEvaluatorsResponse
  - `evaluators` EvaluatorSummary[], required — The list of evaluator summaries containing basic information about each evaluator.
    - `evaluatorArn` string, required — The Amazon Resource Name (ARN) of the evaluator.
    - `evaluatorId` string, required — The unique identifier of the evaluator.
    - `evaluatorName` string, required — The name of the evaluator.
    - `description` string, password — The description of the evaluator.
    - `evaluatorType` 'Builtin' | 'Custom' | 'CustomCode', required — The type of evaluator, indicating whether it is a built-in evaluator provided by the service or a custom evaluator created by the user.
    - `level` 'TOOL_CALL' | 'TRACE' | 'SESSION' — The evaluation level (<code>TOOL_CALL</code>, <code>TRACE</code>, or <code>SESSION</code>) that determines the scope of evaluation.
    - `status` 'ACTIVE' | 'CREATING' | 'CREATE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'DELETING', required — The current status of the evaluator.
    - `createdAt` string, date-time, required — The timestamp when the evaluator was created.
    - `updatedAt` string, date-time, required — The timestamp when the evaluator was last updated.
    - `lockedForModification` boolean — Whether the evaluator is locked for modification due to being referenced by active online evaluation configurations.
    - `kmsKeyArn` string — The Amazon Resource Name (ARN) of the customer managed KMS key used to encrypt the evaluator's sensitive data. This field is only present for evaluators encrypted with a customer managed key.
  - `nextToken` string — The pagination token to use in a subsequent request to retrieve the next page of results.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — 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/revisions/0ebde766792b/schema)