FruxonDocs
AgentsExecution Records

Adds an execution to one or more evaluation datasets as a sample

Snapshots the execution's inputs and outputs into each target dataset as an `EvaluationSample`, tagged with the supplied quality label and free-form tags. Use this to curate real-traffic examples into golden sets, regression suites, or labeled pools that feed evaluation runs. Re-adding the same execution to a dataset creates a new sample row rather than upserting, so callers that want at-most-once semantics should dedupe via `GET .../executionRecords/{executionRecord}/samples` first.

POST
/v1/tenants/{tenant}/agents/{agent}/executionRecords/{executionRecord}:addToDatasets

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The agent identifier.

executionRecord*string

The execution identifier.

tenant*string

The tenant identifier

Request Body

Target dataset ids, quality, and optional tags.

datasetIds?|null

Target dataset identifiers. One sample row is created per dataset.

quality?string

Represents the quality classification of a tagged evaluation sample. Used to indicate whether a given sample is suitable for benchmarking, needs review, or should be excluded from automated testing pipelines.

Value in"UNSPECIFIED" | "GOOD" | "BAD" | "NEEDS_REVIEW"
tags?|null

Optional metadata tags to attach to each sample.

[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/agents/string/executionRecords/string:addToDatasets" \  -H "Content-Type: application/json" \  -d '{}'
[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000",
    "createdAt": 0,
    "modifiedAt": 0,
    "createdBy": "string",
    "datasetId": "00000000-0000-0000-0000-000000000000",
    "executionId": "string",
    "inputPayload": {},
    "output": "string",
    "agentRevision": 0,
    "quality": "GOOD",
    "isGolden": false,
    "tags": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "tenantId": "00000000-0000-0000-0000-000000000000",
        "sampleId": "00000000-0000-0000-0000-000000000000",
        "tag": "string",
        "sample": null
      }
    ]
  }
]
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Lists execution records for an agent.

Returns a paginated list of all executions, ordered by most recent first. Optionally filter by time range using the `startTime` and `endTime` query parameters.

Gets the summary record for a single execution.

Returns the same Fruxon.Model.ExecutionTraces.AgentExecutionRecordResponse shape every item in the list endpoint carries — start/end times, status, token counts, cost breakdown — just for one specific record id. Cheap follow-up to a streaming run: SSE emits the `executionRecordId` in the final `done` event so callers can fetch the canonical summary by id without paging through history.