---
title: "Run Full Evaluation"
method: POST
path: "/reports/{report_id}/run"
tags: ["reports"]
---

# Run Full Evaluation

`POST /reports/{report_id}/run`

## Path parameters

- `report_id` integer, required

## Request body

- object
  - `name` string, required — The name of the final report to be created. Must be between 1 and 255 characters in length.
  - `dataset_id` integer, nullable — The ID of the dataset to use for the report. If not provided, uses the evaluation pipeline's default dataset.
  - `refresh_dataset` boolean, nullable — Whether to refresh the dataset before running the report. Only applicable for dynamic datasets.

## Response `201`

Report run initiated successfully

- object
  - `success` boolean, required
  - `report_id` integer, required — The ID of the created final report.

## Other responses

- `400` — Bad Request - Invalid data or report generation error
- `401` — Unauthorized - No requests found for the given criteria
- `403` — Forbidden - Can only run evaluation pipeline reports or dataset refresh not allowed
- `404` — Not Found - Report or dataset not found
- `422` — Validation error - request parameters or body are invalid.

---

[API](https://skmtc.dev/promptlayer/apis/promptlayer-api.md) · [All operations](https://skmtc.dev/promptlayer/apis/promptlayer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/promptlayer/promptlayer-api/revisions/a23093a0a506/schema)