Generate a self-contained Vizb HTML application from Datasets.

POST

/ui

const url = 'http://127.0.0.1:8080/ui';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"datasets":{"name":"API latency","axes":[{"key":"name"},{"key":"y","type":"value"}],"settings":[{"type":"line","smooth":true}],"data":[{"name":"west","yAxis":"12"},{"name":"east","yAxis":"18"}]},"charts":{"types":["line"]}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url http://127.0.0.1:8080/ui \
  --header 'Content-Type: application/json' \
  --data '{ "datasets": { "name": "API latency", "axes": [ { "key": "name" }, { "key": "y", "type": "value" } ], "settings": [ { "type": "line", "smooth": true } ], "data": [ { "name": "west", "yAxis": "12" }, { "name": "east", "yAxis": "18" } ] }, "charts": { "types": [ "line" ] } }'

The request accepts one Dataset or a non-empty Dataset array. The generated response is returned directly and is never stored by the server. Remote data URLs are deliberately absent from the request model.

Request Body^required

application/json

object

datasets

required

One of:

object
Array<object>

object

string

tag

string

timestamp

string

name

required

string

themes

Data-owned theme catalog. When non-empty, themes[0] is the active theme. New writers emit themes only; legacy theme is migrated on load.

Array<object>

Fully expanded color theme. On Dataset and convert responses, themes[0] is the active theme when the catalog is non-empty.

object

name

required

Theme identifier used by the UI selector.

string

>= 1 characters

colors

required

Categorical series palette.

Array<string>

>= 1 items

visualMapColors

required

Continuous gradient pair (exactly two colors).

Array<string>

>= 2 items <= 2 items

theme

Legacy single theme name or palette. Migrated into themes when themes is empty; omitted from new output after migration.

string

history

Array<object>

object

tag

required

string

timestamp

required

string

meta

object

cpu

object

name

string

cores

integer

string

arch

string

pkg

string

description

string

meta

object

cpu

object

name

string

cores

integer

string

arch

string

pkg

string

axes

required

Array<object>

object

key

required

string

Allowed values: name x y z

label

string

type

string

Allowed values: "" value

settings

required

Each chart type may appear at most once.

data

required

Array<object>

object

name

string

xAxis

string

yAxis

string

zAxis

string

metric

string

stats

Array<object>

object

type

string

value

number

symbol

string

preserveRows

boolean

charts

object

types

Array<string>

>= 1 items unique items

Allowed values: bar line scatter pie heatmap radar sankey chord

configs

Array

One of: discriminator: type

object

type

required

Allowed value: bar

swap

string

sort

object

enabled

required

boolean

order

required

string

Allowed values: asc desc

scale

One of:

string
object

string

Allowed values: linear log

stack

boolean

showLabels

boolean

borderRadius

Array<integer>

>= 1 items <= 4 items

threeDRotate

boolean

threeD

boolean

threeDVisualMap

boolean

horizontal

boolean

background

object

active

boolean

color

string

borderColor

string

borderWidth

number

borderType

string

Allowed values: solid dashed dotted

borderRadius

One of:

integer
Array<integer>

integer

shadowBlur

number

shadowColor

string

shadowOffsetX

number

shadowOffsetY

number

opacity

number

<= 1

stat

object

enabled

required

boolean

math

required

Array<string>

Allowed values: counts center spread extremes shape percentiles confidence correlations

statistics

object

enabled

boolean

math

Array<string>

unique items

Allowed values: counts center spread extremes shape percentiles confidence correlations

Examples

datasetUI

Render one Dataset with a filtered chart set.

{
  "datasets": {
    "name": "API latency",
    "axes": [
      {
        "key": "name"
      },
      {
        "key": "y",
        "type": "value"
      }
    ],
    "settings": [
      {
        "type": "line",
        "smooth": true
      }
    ],
    "data": [
      {
        "name": "west",
        "yAxis": "12"
      },
      {
        "name": "east",
        "yAxis": "18"
      }
    ]
  },
  "charts": {
    "types": [
      "line"
    ]
  }
}

Responses

200

Self-contained HTML was generated successfully.

text/html

string

Examples

selfContainedHTML

<!doctype html><html><head><title>Vizb</title></head><body>...</body></html>

400

The request body is not a single valid JSON value.

application/problem+json

object

type

required

string format: uri-reference

title

required

string

status

required

integer

detail

required

string

instance

string format: uri-reference

errors

required

Array<object>

>= 1 items

object

location

required

string

Allowed values: body header query

path

required

JSON Pointer or header/query name.

string

code

required

string

message

required

string

Example

{
  "errors": [
    {
      "location": "body"
    }
  ]
}

406

The request's Accept header does not allow an operation's selected response media type.

application/problem+json

object

type

required

string format: uri-reference

title

required

string

status

required

integer

detail

required

string

instance

string format: uri-reference

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

413

The request body exceeds the 10 MiB limit.

application/problem+json

object

type

required

string format: uri-reference

title

required

string

status

required

integer

detail

required

string

instance

string format: uri-reference

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

415

The request Content-Type is not application/json.

application/problem+json

object

type

required

string format: uri-reference

title

required

string

status

required

integer

detail

required

string

instance

string format: uri-reference

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

422

Valid JSON violates request schema or semantic constraints, or the supplied input cannot be processed.

application/problem+json

object

type

required

string format: uri-reference

title

required

string

status

required

integer

detail

required

string

instance

string format: uri-reference

Examples

{
  "type": "https://vizb.goptics.org/problems/validation",
  "title": "Unprocessable content",
  "status": 422,
  "detail": "Request validation failed.",
  "instance": "/merge",
  "errors": [
    {
      "location": "body",
      "path": "/tagAxis",
      "code": "invalid_enum",
      "message": "tagAxis must be one of name, x, y, or z."
    }
  ]
}

{
  "type": "https://vizb.goptics.org/problems/processing",
  "title": "Input processing failed",
  "status": 422,
  "detail": "The selected columns could not be read from the CSV input.",
  "instance": "/"
}

500

An unexpected server-side failure occurred.

application/problem+json

object

type

required

string format: uri-reference

title

required

string

status

required

integer

detail

required

string

instance

string format: uri-reference

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

Generate a self-contained Vizb HTML application from Datasets.

Request Bodyrequired

Examples

Responses

200

Examples

400

Example

406

Examplegenerated

413

Examplegenerated

415

Examplegenerated

422

Examples

500

Examplegenerated

Request Body^required

Example^generated

Example^generated

Example^generated

Example^generated