---
title: "Create Eval Config Record"
method: POST
path: "/eval_configs/{id}/records"
---

# Create Eval Config Record

`POST /eval_configs/{id}/records`

## Request

- Base URL: `https://api.vogent.ai/api`
- URL: `https://api.vogent.ai/api/eval_configs/{id}/records`
- Auth: HTTP bearer

Creates a new record for an AI evaluation configuration. Either provide a dialId to link an existing dial, or provide prompt fields to create a prompt-based record.

## Path parameters

- `id` string, required

## Request body

- CreateAIEvalRecordInput: Create either a dial-based record (provide dialId) or a prompt-based record (provide prompt fields).
  - `recordType` 'DIAL' | 'PROMPT', required: The type of evaluation record.
  - `dialId` string: The ID of an existing dial to link (required for DIAL type).
  - `name` string: The name of the prompt (for PROMPT type).
  - `description` string: The description of the prompt (for PROMPT type).
  - `systemPrompt` string: The system prompt (required for PROMPT type).
  - `maxTurns` integer: The maximum number of conversation turns (for PROMPT type, defaults to 20).
  - `agentInputs` string: JSON object of key-value pairs injected as agent variables (for PROMPT type).

## Response `200`

Successful operation

- AIEvalRecord
  - `id` string, required
  - `recordType` 'DIAL' | 'PROMPT', required: The type of evaluation record.
  - `dialId` string, nullable
  - `prompt` AIEvalPrompt
    - `id` string, required
    - `name` string, nullable
    - `description` string, nullable
    - `systemPrompt` string, required
    - `maxTurns` integer, required
    - `agentInputs` string, nullable
    - `createdAt` string, date-time, required

## Other responses

- `400`: Invalid input
- `422`: Validation exception

---

[API](https://skmtc.dev/vogent/apis/vogent-openapi-3-0.md) - [All operations](https://skmtc.dev/vogent/apis/vogent-openapi-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/vogent/apis/vogent-openapi-3-0/revisions/a5966cc364ef?raw)