Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Netdata charts API

Everything related to chart instances - DO NOT USE IN NEW CODE - use contexts instead

Netdata charts API is one of 20 APIs that Netdata publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include charts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 3 operations across 3 paths, and defines 38 schemas. It is described by OpenAPI 3.0.0, at version v1-rolling.

Requests are made against 3 base URLs: https://registry.my-netdata.io, http://registry.my-netdata.io, http://localhost:19999.

3 operations 3 paths 38 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
v1-rolling
Base URL
http://localhost:19999
Authentication
HTTP Bearer, HTTP Bearer, API Key
License
Resource Areas
1

Authentication & Security 3

Netdata charts API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It accepts HTTP bearer tokens (aclkAuth). An API key is passed in the header as X-Forwarded-For (ipAcl).

  • bearerAuth — Bearer token authentication for API access when bearer protection is enabled. How to obtain a token: 1. Token must be obtained via /api/v3/bearergettoken endpo…
  • aclkAuth — ACLK-only authentication - these APIs are ONLY accessible via Netdata Cloud (ACLK). Access Requirements: - User must be authenticated via Netdata Cloud (SIGNED…
  • ipAcl — IP-based Access Control List restrictions (informational only). Configuration: APIs are subject to IP-based ACL restrictions configured in netdata.conf: conf […

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

charts 3

Everything related to chart instances - DO NOT USE IN NEW CODE - use contexts instead

GET
/api/v1/chartsdeprecated
List all charts v1 - EOL
getNodeCharts1 → 200
GET
/api/v1/chartdeprecated
Get one chart v1 - EOL
getNodeChart1 1 param → 200400404
POST
/api/v3/spaces/{spaceID}/rooms/{roomID}/data
Time series data queries
post-scope-data 2 params body → 200400401500

Schemas 38

The contract defines 38 schemas that model the data the API accepts and returns. The most detailed are chart (18 properties), chart_summary (13 properties), github_com_netdata_cloud-charts-service_internal_model.View (11 properties), github_com_netdata_cloud-charts-service_internal_model.ScopeDataResponse (10 properties). Each schema is shown below with its type and property counts.

github_com_netdata_cloud-charts-service_internal_model.WindowSpan
object
4 properties
github_com_netdata_cloud-charts-service_internal_model.MetricsAggregation
object
3 properties
github_com_netdata_cloud-charts-service_internal_model.DB
object
7 properties
errors.ValidationError
object
2 properties
github_com_netdata_cloud-charts-service_internal_model.View
object
11 properties
github_com_netdata_cloud-charts-service_internal_model.ViewDimensions
object
8 properties
github_com_netdata_cloud-charts-service_internal_model.ScopeDataResponse
object
10 properties
github_com_netdata_cloud-charts-service_internal_model.TimeAggregation
object
3 properties
github_com_netdata_cloud-charts-service_internal_model.ScopeDataRequest
object
7 properties
github_com_netdata_cloud-charts-service_internal_model.Result
object
3 properties
chart_variables
object
2 properties
chart_summary
object
13 properties
github_com_netdata_cloud-charts-service_internal_model.Versions
object
5 properties
github_com_netdata_cloud-charts-service_internal_model.GlobalSummary
object
1 property
github_com_netdata_cloud-charts-service_internal_model.StatsArray
object
9 properties
github_com_netdata_cloud-charts-service_internal_model.AgentSummary
object
6 properties
github_com_netdata_cloud-charts-service_internal_model.PartialDataTrimming
object
3 properties
github_com_netdata_cloud-charts-service_internal_model.ItemsCount
object
4 properties
github_com_netdata_cloud-charts-service_internal_model.LabelSummary
object
4 properties
github_com_netdata_cloud-charts-service_internal_model.Scope
object
5 properties
github_com_netdata_cloud-charts-service_internal_model.DimensionSummary
object
5 properties
github_com_netdata_cloud-charts-service_internal_model.Tier
object
6 properties
chart
object
18 properties
github_com_netdata_cloud-charts-service_internal_model.Window
object
6 properties
github_com_netdata_cloud-charts-service_internal_model.ContextSummary
object
5 properties
github_com_netdata_cloud-charts-service_internal_model.Selectors
object
6 properties
github_com_netdata_cloud-charts-service_internal_model.AggregationMethod
string
github_com_netdata_cloud-charts-service_internal_model.Summary
object
7 properties
github_com_netdata_cloud-charts-service_internal_model.Totals
object
6 properties
github_com_netdata_cloud-charts-service_internal_model.Aggregations
object
2 properties
github_com_netdata_cloud-charts-service_internal_model.LabelValueSummary
object
3 properties
errors.Error
object
5 properties
github_com_netdata_cloud-charts-service_internal_model.NodeSummary
object
9 properties
github_com_netdata_cloud-charts-service_internal_model.NodeStatus
object
4 properties
github_com_netdata_cloud-charts-service_internal_model.AlertSummary
object
5 properties
github_com_netdata_cloud-charts-service_internal_model.Timings
object
7 properties
github_com_netdata_cloud-charts-service_internal_model.DBDimensions
object
3 properties
github_com_netdata_cloud-charts-service_internal_model.InstanceSummary
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

netdata-charts-api-openapi.yml Raw ↑

Other APIs Netdata publishes across the network.

Netdata Agent API
Netdata alerts API
Netdata authentication API
Netdata badges API
Netdata claiming API
Netdata config API
Netdata contexts API
Netdata data API
Netdata dyncfg API
Netdata functions API
Netdata management API
Netdata nodes API