Skip to main content
POST
/
api
/
v1
/
runtime
/
observability
/
dashboard-cards
Upsert a dashboard card (CLI metrics sync)
curl --request POST \
  --url https://api.runflow.ai/api/v1/runtime/observability/dashboard-cards \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "<string>",
  "title": "<string>",
  "config": {},
  "tabId": "<string>",
  "gridLayout": {
    "x": 123,
    "y": 123,
    "w": 123,
    "h": 123
  },
  "sortOrder": 123,
  "idempotencyKey": "<string>"
}
'

Body

application/json
​
agentId
string
required

Agent UUID

​
title
string
required
​
cardType
enum<string>
required

Card visualization type. All 8 types supported: number, rate, line, bar, pie, table, funnel, gauge.

Available options:
number,
rate,
line,
bar,
pie,
table,
funnel,
gauge
​
config
object
required

Card-type-specific config. Polymorphic shape — see @runflow/shared dashboard-cards types for the per-type required fields.

​
tabId
string

Optional dashboard tab (UUID).

​
gridLayout
object

Optional grid position (x, y, w, h). Stored in config.

​
sortOrder
number
​
idempotencyKey
string

Optional caller-supplied key.

Response

Card upserted successfully.