# Create an eval

> Binds an agent under test to a dataset and a list of scorers. The agent and the dataset must belong to the same project as the eval; a cross-project reference is rejected with 400.

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create an eval"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/api/v1/evals"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Binds an agent under test to a dataset and a list of scorers. The agent and the dataset must belong to the same project as the eval; a cross-project reference is rejected with 400.

Scorer config is frozen here rather than read from the agent at run time, so two runs of the same eval are always judged by the same criteria and their comparison measures the agent instead of the config drifting underneath it. Each scorer `type` may appear at most once.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails>
  
</ParamsDetails>

<RequestSchema
  {...require("./create-eval.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./create-eval.StatusCodes.json")}
>
  
</StatusCodes>