Skip to content
Plune Plune Plune Docs

The project’s widgets

GET
/v1/widgets
 
curl --request GET \
  --url https://beta-api.plune.ai/v1/widgets \
  --header 'Authorization: Bearer <token>'

The active widgets of the project, in dashboard order. Every member sees them all; a reader reads and cannot write.

Authorizations

Section titled “Authorizations ”

Responses

Section titled “ Responses ”

200

Section titled “200 ”

The widgets

Media type application/json
object
widgets
required
Array<object>
object
id
required
string format: uuid
projectId
required
string
title
required
string
>= 1 characters <= 120 characters
config
required

The whole recipe of a widget; the server judges it on every write and every draft. Entities: case, run_result, run, requirement (a defect is not one yet). Properties come from a closed catalogue: a case has type, state, priority, suite, is_flaky, is_muted, tag; a result status, sub_status, source, muted, case_priority, environment, label; a run kind, environment, status_event, label; a requirement type, status, priority, category. A donut takes one block. A segment is cut across all blocks and only by a property they all have (label for runs and results; any groupable property for a single entity). Limits: 5 blocks, 10 segment values, 10 filters a block, 16 KiB.

object
schemaVersion
required
integer
Allowed values: 1
render
required
string
Allowed values: bar line donut table
bucket
string
default: day
Allowed values: day week month
accumulated

Line only: the population at each moment. For run_result and run (they only arrive); a case, a requirement and a defect wait.

boolean
blocks
required
Array<object>
>= 1 items <= 5 items
object
entity
required
string
Allowed values: case run_result run requirement
metric

A duration only for run_result and run.

string
default: count
Allowed values: count duration_sum duration_avg
filters
Array<object>
<= 10 items
object
property
required
string
values
required
Array<string>
>= 1 items <= 50 items
groupBy

A groupable property of the entity. More than 20 groups: the rest is folded into «Other» with a true sum.

string
segment
object
by
required
string
values
required
Array<string>
>= 1 items <= 10 items
position
required

The order on the dashboard.

integer
createdBy
required
string
nullable
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
Example 
{
  "widgets": [
    {
      "id": "6f1c2b3a-0000-4000-8000-0000000000b4",
      "projectId": "u-shop::default",
      "title": "Automated runs and failures",
      "config": {
        "schemaVersion": 1,
        "render": "line",
        "bucket": "day",
        "accumulated": false,
        "blocks": [
          {
            "entity": "run",
            "metric": "count",
            "filters": [
              {
                "property": "kind",
                "values": [
                  "automated"
                ]
              }
            ]
          },
          {
            "entity": "run_result",
            "metric": "count",
            "filters": [
              {
                "property": "status",
                "values": [
                  "failed",
                  "broken"
                ]
              }
            ]
          }
        ],
        "segment": {
          "by": "label",
          "values": [
            "nightly"
          ]
        }
      },
      "position": 0,
      "createdBy": "u-shop",
      "createdAt": "2026-09-16T09:12:04.151Z",
      "updatedAt": "2026-09-16T09:12:04.151Z"
    }
  ]
}

401

Section titled “401 ”

No / invalid token or session