PrompticPromptic

Create an evaluation

POST
/components/{componentId}/evaluations

Authorization

BearerApiKey
AuthorizationBearer <token>

API key from AI Application settings

In: header

Path Parameters

componentId*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://loading/api/v1/components/497f6eca-6276-4993-bfeb-53cbbbba6f08/evaluations" \  -H "Content-Type: application/json" \  -d '{    "datasetId": "6586f21b-ad4d-4d06-a309-712af47184a2"  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "status": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}

List evaluations for a component GET

Evaluations are scoped by `subject` (what the judge looks at: output / trajectory / annotation) and anchored to a durable resource by `targetType` (trace / run / dataset). The anchor IDs follow the target type: `trace` evaluations populate only `traceDbId`; `dataset` evaluations populate only `datasetId`; `run` evaluations populate both `runId` and `datasetId` (since a run belongs to a dataset).

Get an evaluation by ID GET

Returns the evaluation envelope: identity, status, scope (`subject` / `targetType`), and the populated anchor IDs that match the target type. The `results` field still carries the aggregated insight payload for dataset and run evaluations; for canonical per-(target, judge) rows, fetch `/evaluations/{evaluationId}/judge-results`.