---
title: "Restart an evaluation"
method: POST
path: "/evaluations/{evaluation_id}/restart"
tags: ["Evaluations"]
---

# Restart an evaluation

`POST /evaluations/{evaluation_id}/restart`

Restarts an existing evaluation with optional new parameters (comment, custom instructions, or model)

## Path parameters

- `evaluation_id` string, required

## Request body

- RestartEvaluationRequest — Request body for restarting an evaluation with optional new parameters
  - `comment` string — Optional updated comment for the restarted evaluation
  - `custom_instructions` string — Optional updated custom instructions for the AI model
  - `model_id` string — Optional new model ID to use for the restarted evaluation

## Response `200`

Evaluation successfully restarted

- CreateEvaluationResponse — Response after creating or restarting an evaluation
  - `evaluation` EvaluationDetails, required — Detailed evaluation object returned after creation or restart
    - `_id` string, required — Unique identifier for the evaluation
    - `name` string, required — Name of the evaluation
    - `data` object[] — Evaluation data (empty at creation)
    - `user_id` string, required — ID of the user who created the evaluation
    - `skill` object, required — Skill/bot being evaluated
      - `_id` string
      - `name` string
    - `dataset` object, required — Dataset used for evaluation
      - `_id` string
      - `name` string
    - `model` object, required — AI model used for evaluation
      - `_id` string
      - `name` string
      - `model_name` string
      - `provider` string
    - `status` 'in progress' | 'terminated' | 'pending' | 'failed', required — Current status of the evaluation
    - `progress` number, float, required — Completion progress (percentage)
    - `score` number, float, required — Current score (percentage)
    - `nb_questions` integer, required — Total number of questions
    - `is_child` boolean, required — Indicates if this is a restarted evaluation (child of original)
    - `comment` string — Comment or description
    - `custom_instructions` string — Custom instructions for the AI model
    - `createdAt` string, date-time, required — Creation timestamp
    - `updatedAt` string, date-time, required — Last update timestamp
    - `__v` integer — Version key
  - `message` string, required — Success message

## Other responses

- `400` — Invalid request - Invalid model_id
- `401` — Unauthorized - Invalid or missing authentication
- `404` — Evaluation not found
- `500` — Internal server error

---

[API](https://skmtc.net/smartly/apis/smartly-ai-apis.md) · [All operations](https://skmtc.net/smartly/apis/smartly-ai-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartly/smartly-ai-apis/revisions/1e26909d86c9/schema)