Cekura · Schema

Widget

Widget configuration. Key rules: - `line` / `pie`: set `field` only (e.g. `"duration"`, `"call_ended_reason"`). No aggregation needed. - `bar`: set `field` + `aggregation_function` (e.g. `"count"`) + `time_period` (e.g. `"day"`). - `stat`: leave `field` empty — returns total_calls, success_rate, avg_duration, p95_latency. - `field = "metric_evaluations.value"`: `metric` (integer metric ID) is **required**. Get valid IDs from `GET /test_framework/v1/metrics?agent_id=`. - `effective_filters` (read-only): merged dashboard + widget filters — useful for debugging.

CompanyVoice AIQATestingBenchmarking

Properties

Name Type Description
id integer
dashboard integernull Dashboard this widget belongs to
name stringnull Optional name/title for the widget
filters objectnull Filter conditions to scope the data. See the [Dashboards guide](https://docs.cekura.ai/documentation/guides/dashboards#filters) for supported fields, operators, and syntax.
effective_filters object Merged filters from dashboard and widget (read-only). Can be used with the call logs API filters_v2 parameter.
chart_type string Type of chart to display * `line` - Line * `bar` - Bar * `pie` - Pie * `stat` - Stat
data_type stringnull Data type of the field being plotted (optional, can be inferred) * `numeric` - Numeric * `boolean` - Boolean * `string` - String * `datetime` - DateTime * `dynamic` - Dynamic
field string Field name to plot. See the [Dashboards guide](https://docs.cekura.ai/documentation/guides/dashboards#supported-fields) for available fields, valid chart types, and aggregation combinations.
metric integernull Metric to use when field is 'metric_evaluations.value'
metric_name string Name of the metric (if metric is set)
time_period stringnull Time period for aggregation (for bar charts) * `hour` - Hour * `day` - Day * `week` - Week * `month` - Month
aggregation_function stringnull Aggregation function to apply (for bar charts) * `count` - Count * `sum` - Sum * `avg` - Average * `min` - Minimum * `max` - Maximum * `p50` - 50th Percentile (Median) * `p95` - 95th Percentile * `p99
group_by object Optional group-by configuration. Field group: `{"type": "field", "field": "agent.id"}`. Time bucket: `{"type": "bucket", "interval": 3600000}` (interval in milliseconds). Leave null or empty for no gr
metadata object Frontend metadata (e.g., position, size, styling)
created_at stringnull When the widget was created
updated_at stringnull When the widget was last updated
View JSON Schema on GitHub

JSON Schema

cekura-ai-widget-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cekura-ai/json-schema/cekura-ai-widget-schema.json",
  "title": "Widget",
  "description": "Widget configuration. Key rules:\n- `line` / `pie`: set `field` only (e.g. `\"duration\"`, `\"call_ended_reason\"`). No aggregation needed.\n- `bar`: set `field` + `aggregation_function` (e.g. `\"count\"`) + `time_period` (e.g. `\"day\"`).\n- `stat`: leave `field` empty — returns total_calls, success_rate, avg_duration, p95_latency.\n- `field = \"metric_evaluations.value\"`: `metric` (integer metric ID) is **required**.\n  Get valid IDs from `GET /test_framework/v1/metrics?agent_id=<id>`.\n- `effective_filters` (read-only): merged dashboard + widget filters — useful for debugging.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cekura-ai-dashboards-api-openapi.yml#/components/schemas/Widget",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "readOnly": true
    },
    "dashboard": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Dashboard this widget belongs to"
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional name/title for the widget",
      "maxLength": 255
    },
    "filters": {
      "type": [
        "object",
        "null"
      ],
      "description": "Filter conditions to scope the data. See the [Dashboards guide](https://docs.cekura.ai/documentation/guides/dashboards#filters) for supported fields, operators, and syntax.",
      "properties": {
        "field": {
          "type": "string",
          "description": "Field name to filter on"
        },
        "op": {
          "type": "string",
          "enum": [
            "eq",
            "neq",
            "gt",
            "gte",
            "lt",
            "lte",
            "contains",
            "startswith",
            "endswith",
            "in",
            "isnull",
            "regex"
          ],
          "description": "Comparison operator"
        },
        "value": {
          "description": "Value to compare against. Type depends on the field and operator."
        },
        "operator": {
          "type": "string",
          "enum": [
            "and",
            "or",
            "same_row"
          ],
          "description": "Logical operator to combine conditions"
        },
        "conditions": {
          "type": "array",
          "description": "List of filter conditions or nested groups",
          "items": {}
        }
      }
    },
    "effective_filters": {
      "type": "object",
      "description": "Merged filters from dashboard and widget (read-only). Can be used with the call logs API filters_v2 parameter.",
      "properties": {
        "field": {
          "type": "string",
          "description": "Field name to filter on"
        },
        "op": {
          "type": "string",
          "enum": [
            "eq",
            "neq",
            "gt",
            "gte",
            "lt",
            "lte",
            "contains",
            "startswith",
            "endswith",
            "in",
            "isnull",
            "regex"
          ],
          "description": "Comparison operator"
        },
        "value": {
          "description": "Value to compare against. Type depends on the field and operator."
        },
        "operator": {
          "type": "string",
          "enum": [
            "and",
            "or",
            "same_row"
          ],
          "description": "Logical operator to combine conditions"
        },
        "conditions": {
          "type": "array",
          "description": "List of filter conditions or nested groups",
          "items": {}
        }
      },
      "readOnly": true
    },
    "chart_type": {
      "enum": [
        "line",
        "bar",
        "pie",
        "stat"
      ],
      "type": "string",
      "x-spec-enum-id": "458699e47c376d15",
      "description": "Type of chart to display\n\n* `line` - Line\n* `bar` - Bar\n* `pie` - Pie\n* `stat` - Stat"
    },
    "data_type": {
      "enum": [
        "numeric",
        "boolean",
        "string",
        "datetime",
        "dynamic",
        "",
        null
      ],
      "type": [
        "string",
        "null"
      ],
      "x-spec-enum-id": "553dbfa7e4c5fb6a",
      "description": "Data type of the field being plotted (optional, can be inferred)\n\n* `numeric` - Numeric\n* `boolean` - Boolean\n* `string` - String\n* `datetime` - DateTime\n* `dynamic` - Dynamic"
    },
    "field": {
      "type": "string",
      "description": "Field name to plot. See the [Dashboards guide](https://docs.cekura.ai/documentation/guides/dashboards#supported-fields) for available fields, valid chart types, and aggregation combinations.",
      "default": "",
      "maxLength": 255
    },
    "metric": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Metric to use when field is 'metric_evaluations.value'"
    },
    "metric_name": {
      "type": "string",
      "readOnly": true,
      "description": "Name of the metric (if metric is set)"
    },
    "time_period": {
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "",
        null
      ],
      "type": [
        "string",
        "null"
      ],
      "x-spec-enum-id": "c3b53047d634938d",
      "description": "Time period for aggregation (for bar charts)\n\n* `hour` - Hour\n* `day` - Day\n* `week` - Week\n* `month` - Month"
    },
    "aggregation_function": {
      "enum": [
        "count",
        "sum",
        "avg",
        "min",
        "max",
        "p50",
        "p95",
        "p99",
        "",
        null
      ],
      "type": [
        "string",
        "null"
      ],
      "x-spec-enum-id": "be3fac57dbd138ef",
      "description": "Aggregation function to apply (for bar charts)\n\n* `count` - Count\n* `sum` - Sum\n* `avg` - Average\n* `min` - Minimum\n* `max` - Maximum\n* `p50` - 50th Percentile (Median)\n* `p95` - 95th Percentile\n* `p99` - 99th Percentile"
    },
    "group_by": {
      "oneOf": [
        {},
        {
          "type": "null"
        }
      ],
      "description": "Optional group-by configuration. Field group: `{\"type\": \"field\", \"field\": \"agent.id\"}`. Time bucket: `{\"type\": \"bucket\", \"interval\": 3600000}` (interval in milliseconds). Leave null or empty for no grouping."
    },
    "metadata": {
      "oneOf": [
        {},
        {
          "type": "null"
        }
      ],
      "description": "Frontend metadata (e.g., position, size, styling)"
    },
    "created_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "readOnly": true,
      "description": "When the widget was created"
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "readOnly": true,
      "description": "When the widget was last updated"
    }
  },
  "required": [
    "chart_type"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/cekura-ai-widget"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.