curl -X POST https://app.tracia.io/api/v1/spans/sp_abc123def456/evaluations \
  -H "Authorization: Bearer tr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "evaluatorKey": "quality",
    "value": 1,
    "note": "Response was accurate and helpful"
  }'

import { Tracia, Eval } from 'tracia';

const tracia = new Tracia({ apiKey: process.env.TRACIA_API_KEY });

await tracia.spans.evaluate('sp_abc123def456', {
  evaluator: 'quality',
  value: Eval.POSITIVE,
  note: 'Response was accurate and helpful'
});

{
  "id": "eval_xyz789",
  "evaluatorKey": "quality",
  "evaluatorName": "Quality",
  "value": 1,
  "source": "api",
  "note": "Response was accurate and helpful",
  "createdAt": "2024-01-15T10:35:00.000Z"
}

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid evaluation value. Must be a number."
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Span not found: sp_abc123def456"
  }
}