FruxonDocs
AgentsExecution Records

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.

GET
/v1/tenants/{tenant}/agents/{agent}/executionRecords

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 unique identifier of the agent.

tenant*string

The tenant identifier

Query Parameters

PageSize?integer
Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.

StartTime?integer

Filter start time (Unix timestamp in milliseconds, inclusive). Omit to return records from any start time.

Formatint64
EndTime?integer

Filter end time (Unix timestamp in milliseconds, inclusive). Omit to return records up to the current time.

Formatint64
Environment?string

Filter by environment slug. Omit to return records from all environments.

Status?array<AgentExecutionRecordStatus>

Filter by execution status. Repeat the query parameter (e.g. ?status=Completed&status=Failed) to match any of the provided statuses. Omit to return records in any status.

AgentRevision?array<integer>

Filter by agent revision number. Repeat the query parameter (e.g. ?agentRevision=1&agentRevision=2) to match any of the provided revisions. Omit to return records across all revisions.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/executionRecords"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "agentId": "string",
      "agentRevision": 0,
      "remoteAgentRevision": "string",
      "startTime": 0,
      "endTime": 0,
      "status": "IN_PROGRESS",
      "deliveryStatus": "NOT_APPLICABLE",
      "inputTokens": 0,
      "outputTokens": 0,
      "cachedTokens": 0,
      "hasResult": false,
      "hasTrace": false,
      "isSample": false,
      "trigger": {
        "type": "UNSPECIFIED",
        "id": "string",
        "provider": "string"
      },
      "destinations": [],
      "environmentSlug": "string",
      "createdAt": 0,
      "tenantId": "00000000-0000-0000-0000-000000000000",
      "inputCost": 0,
      "outputCost": 0,
      "cachedCost": 0,
      "thinkingCost": 0,
      "totalCost": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Gets per-environment execution summaries for an agent.

Returns aggregated execution count, total cost, and last activity time for each environment that has execution records for this agent.

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.