RunReveal

AgentRunsFacets returns the disjunctive filter-menu aggregates (agentID, provider) for the agent runs list given the current filter context. Counts are disjunctive so multi-select stays useful; the agentID facet is high-cardinality (top-N + type-ahead via FacetKey/FacetQuery).

AgentRunsFacets returns the disjunctive filter-menu aggregates (agentID, provider) for the agent runs list given the current filter context. Counts are disjunctive so multi-select stays useful; the agentID facet is high-cardinality (top-N + type-ahead via FacetKey/FacetQuery).

POST
/agent-runs/facets

Request Body

application/jsonRequired

agentIDarray<string>

agentIDModestring

facetKeystring

facetQuerystring

fromobject

limitinteger

offsetinteger

providerarray<string>

providerModestring

searchstring

sortstring

statusstring

toobject

curl -X POST "https://api.runreveal.com/agent-runs/facets" \
  -H "Content-Type: application/json" \
  -d '{
    "agentID": [
      "string"
    ],
    "agentIDMode": "string",
    "facetKey": "string",
    "facetQuery": "string",
    "from": {},
    "limit": 0,
    "offset": 0,
    "provider": [
      "string"
    ],
    "providerMode": "string",
    "search": "string",
    "sort": "string",
    "status": "string",
    "to": {}
  }'

Success

{
  "error": "string",
  "errorCode": "string",
  "result": {
    "buckets": {
      "property1": [
        {
          "count": 0,
          "label": "string",
          "value": "string"
        }
      ],
      "property2": [
        {
          "count": 0,
          "label": "string",
          "value": "string"
        }
      ]
    }
  },
  "success": true
}

AgentRunsList returns one offset page of the workspace's agent runs (rows of the ClickHouse agent_schedule_runs table) plus a total over the same time window and filters. The window defaults to the last 7 days when the request omits it, so the scan is always bounded.

AgentRunsList returns one offset page of the workspace's agent runs (rows of the ClickHouse agent_schedule_runs table) plus a total over the same time window and filters. The window defaults to the last 7 days when the request omits it, so the scan is always bounded.

POST
/agent-runs/list

Request Body

application/jsonRequired

agentIDarray<string>

agentIDModestring

facetKeystring

facetQuerystring

fromobject

limitinteger

offsetinteger

providerarray<string>

providerModestring

searchstring

sortstring

statusstring

toobject

curl -X POST "https://api.runreveal.com/agent-runs/list" \
  -H "Content-Type: application/json" \
  -d '{
    "agentID": [
      "string"
    ],
    "agentIDMode": "string",
    "facetKey": "string",
    "facetQuery": "string",
    "from": {},
    "limit": 0,
    "offset": 0,
    "provider": [
      "string"
    ],
    "providerMode": "string",
    "search": "string",
    "sort": "string",
    "status": "string",
    "to": {}
  }'

Success

{
  "error": "string",
  "errorCode": "string",
  "result": {
    "limit": 0,
    "offset": 0,
    "total": 0,
    "values": [
      {
        "agentID": "string",
        "agentName": "string",
        "chatID": "string",
        "createdAt": {},
        "error": "string",
        "executionID": "string",
        "executionTime": 0,
        "id": "string",
        "params": {
          "property1": "string",
          "property2": "string"
        },
        "prompt": "string",
        "provider": "string",
        "response": "string",
        "workspaceID": "string"
      }
    ]
  },
  "success": true
}