# Graphy SDK

- [Graphy](https://docs.graphy.dev/index.md)
- [Introduction](https://docs.graphy.dev/sdk-next/index.md)
- [Quickstart](https://docs.graphy.dev/sdk-next/quickstart.md)
- [Data structure](https://docs.graphy.dev/sdk-next/data-structure.md)
- [Licence & evaluation](https://docs.graphy.dev/licence/evaluation.md)
- [How a chart is built](https://docs.graphy.dev/sdk-next/concepts/how-a-chart-is-built.md)
- [Mappings & aesthetics](https://docs.graphy.dev/sdk-next/concepts/mappings.md)
- [Geoms & layers](https://docs.graphy.dev/sdk-next/concepts/geoms.md)
- [Scales](https://docs.graphy.dev/sdk-next/concepts/scales.md)
- [Coordinate systems](https://docs.graphy.dev/sdk-next/concepts/coordinate-systems.md)
- [Serializable spec](https://docs.graphy.dev/sdk-next/concepts/serializable-spec.md)
- [Overview](https://docs.graphy.dev/sdk-next/graph-types/index.md)
- [Line](https://docs.graphy.dev/sdk-next/graph-types/line.md)
- [Bar & column](https://docs.graphy.dev/sdk-next/graph-types/bar.md)
- [Area](https://docs.graphy.dev/sdk-next/graph-types/area.md)
- [Pie & donut](https://docs.graphy.dev/sdk-next/graph-types/pie.md)
- [Radar & radial](https://docs.graphy.dev/sdk-next/graph-types/radial.md)
- [Scatter & bubble](https://docs.graphy.dev/sdk-next/graph-types/scatter.md)
- [Heatmap](https://docs.graphy.dev/sdk-next/graph-types/heatmap.md)
- [Dumbbell](https://docs.graphy.dev/sdk-next/graph-types/dumbbell.md)
- [Lollipop](https://docs.graphy.dev/sdk-next/graph-types/lollipop.md)
- [Candlestick](https://docs.graphy.dev/sdk-next/graph-types/candlestick.md)
- [Boxplot](https://docs.graphy.dev/sdk-next/graph-types/boxplot.md)
- [Waterfall](https://docs.graphy.dev/sdk-next/graph-types/waterfall.md)
- [Funnel](https://docs.graphy.dev/sdk-next/graph-types/funnel.md)
- [Error bar](https://docs.graphy.dev/sdk-next/graph-types/error-bar.md)
- [Mekko](https://docs.graphy.dev/sdk-next/graph-types/mekko.md)
- [Sankey](https://docs.graphy.dev/sdk-next/graph-types/sankey.md)
- [Combo](https://docs.graphy.dev/sdk-next/graph-types/combo.md)
- [Overview](https://docs.graphy.dev/sdk-next/themes/overview.md): Every theme at a glance
- [Bauhaus](https://docs.graphy.dev/sdk-next/themes/bauhaus.md)
- [Blueprint](https://docs.graphy.dev/sdk-next/themes/blueprint.md)
- [Botanical](https://docs.graphy.dev/sdk-next/themes/botanical.md)
- [Chalkboard](https://docs.graphy.dev/sdk-next/themes/chalkboard.md)
- [Comic](https://docs.graphy.dev/sdk-next/themes/comic.md)
- [Financial](https://docs.graphy.dev/sdk-next/themes/financial.md)
- [Gamma](https://docs.graphy.dev/sdk-next/themes/gamma.md)
- [Graphite](https://docs.graphy.dev/sdk-next/themes/graphite.md)
- [Halloween](https://docs.graphy.dev/sdk-next/themes/halloween.md)
- [Neo Brutalist](https://docs.graphy.dev/sdk-next/themes/neo-brutalist.md)
- [Phosphor](https://docs.graphy.dev/sdk-next/themes/phosphor.md)
- [Shiny](https://docs.graphy.dev/sdk-next/themes/shiny.md)
- [Solarized](https://docs.graphy.dev/sdk-next/themes/solarized.md)
- [Spreadsheet](https://docs.graphy.dev/sdk-next/themes/spreadsheet.md)
- [Typewriter](https://docs.graphy.dev/sdk-next/themes/typewriter.md)
- [Watercolor](https://docs.graphy.dev/sdk-next/themes/watercolor.md)
- [Annotations & emphasis](https://docs.graphy.dev/sdk-next/emphasis/index.md)
- [Highlights](https://docs.graphy.dev/sdk-next/emphasis/highlights.md)
- [Reference lines](https://docs.graphy.dev/sdk-next/emphasis/reference-lines.md)
- [Annotations](https://docs.graphy.dev/sdk-next/emphasis/annotations.md)
- [Overview](https://docs.graphy.dev/sdk-next/rendering/index.md)
- [Provider & renderer](https://docs.graphy.dev/sdk-next/rendering/provider-and-renderer.md)
- [Sizing](https://docs.graphy.dev/sdk-next/rendering/sizing.md)
- [Theming](https://docs.graphy.dev/sdk-next/rendering/theming.md)
- [Formatting & locale](https://docs.graphy.dev/sdk-next/rendering/formatting.md)
- [Interactivity](https://docs.graphy.dev/sdk-next/rendering/interactivity.md)
- [Live data](https://docs.graphy.dev/sdk-next/rendering/live-data.md)
- [Overview](https://docs.graphy.dev/sdk-next/config/index.md)
- [Styling](https://docs.graphy.dev/sdk-next/config/styling.md)
- [Content](https://docs.graphy.dev/sdk-next/config/content.md)
- [Axes](https://docs.graphy.dev/sdk-next/config/axes.md)
- [Legend](https://docs.graphy.dev/sdk-next/config/legend.md)
- [Headline numbers](https://docs.graphy.dev/sdk-next/config/headline-numbers.md)
- [Data labels](https://docs.graphy.dev/sdk-next/config/data-labels.md)
- [Number format](https://docs.graphy.dev/sdk-next/config/number-format.md)
- [Layout](https://docs.graphy.dev/sdk-next/config/layout.md)
- [Statistics](https://docs.graphy.dev/sdk-next/advanced/statistics.md)
- [Transforms](https://docs.graphy.dev/sdk-next/advanced/transforms.md)
- [Commands & history](https://docs.graphy.dev/sdk-next/advanced/commands-and-history.md)
- [Extending](https://docs.graphy.dev/sdk-next/extending/index.md)
- [Slots](https://docs.graphy.dev/sdk-next/extending/slots.md)
- [Custom geoms](https://docs.graphy.dev/sdk-next/extending/custom-geoms.md)
- [Geom renderers](https://docs.graphy.dev/sdk-next/extending/geom-renderers.md)
- [Quickstart](https://docs.graphy.dev/agents/quickstart.md)
- [API keys](https://docs.graphy.dev/agents/api-keys.md)
- [Overview](https://docs.graphy.dev/agents/overview.md)
- [Version management](https://docs.graphy.dev/agents/versioning.md)
- [Licence & evaluation](https://docs.graphy.dev/licence/evaluation.md)
- [Installation](https://docs.graphy.dev/agents/sdk/installation.md)
- [Configuration](https://docs.graphy.dev/agents/sdk/configuration.md)
- [Chart Maker Agent](https://docs.graphy.dev/agents/sdk/chart-maker.md)
- [Suggestions Agent](https://docs.graphy.dev/agents/sdk/suggestions.md)
- [Mutation Agent](https://docs.graphy.dev/agents/sdk/mutate.md)
- [Annotation Agent](https://docs.graphy.dev/agents/sdk/annotate.md)
- [Narrative Agent](https://docs.graphy.dev/agents/sdk/narrate.md)
- [Extract Agent](https://docs.graphy.dev/agents/sdk/extract.md)
- [Evaluation](https://docs.graphy.dev/agents/sdk/evaluate.md)
- [Streaming](https://docs.graphy.dev/agents/sdk/streaming.md)
- [Error Handling](https://docs.graphy.dev/agents/sdk/errors.md)
- [Authentication](https://docs.graphy.dev/agents/rest/authentication.md)
- [Keyless access](https://docs.graphy.dev/agents/rest/keyless.md)
- [Chart Maker Agent](https://docs.graphy.dev/agents/rest/chart-maker.md): Modify charts using natural language. Send a GraphConfig and a prompt, receive an updated GraphConfig.
- [Suggestions Agent](https://docs.graphy.dev/agents/rest/suggestions.md): Generate chart type and data preparation suggestions from a dataset. Send a GraphConfig and a prompt, receive suggested visualizations.
- [Mutation Agent](https://docs.graphy.dev/agents/rest/mutate.md): Transform a chart's dataset with natural language — filter, group, aggregate, derive, sort.
- [Annotation Agent](https://docs.graphy.dev/agents/rest/annotate.md): Add highlights, tooltips, stickers, and other annotations to a chart with natural language.
- [Narrative Agent](https://docs.graphy.dev/agents/rest/narrate.md): Generate a chart's title, subtitle, and caption. Narrative is written into config.content as TipTap JSON. Requires userPrompt.
- [Extract Agent](https://docs.graphy.dev/agents/rest/extract.md): Build a chart-ready dataset from unstructured text, images, PDFs, or .xlsx spreadsheets. Provide sourceText, attachments, or both.
- [Evaluation](https://docs.graphy.dev/agents/rest/evaluate.md): Score how well every chart type fits a dataset. Deterministic — a rule-based scorer with no language model, so it returns a single result and uses no tokens. Only config.data is scored.
- [SSE Format](https://docs.graphy.dev/agents/rest/sse.md)
- [Error Codes](https://docs.graphy.dev/agents/rest/errors.md)
- [Type Reference](https://docs.graphy.dev/agents/reference/types.md)
- [Quickstart](https://docs.graphy.dev/data-import-utils/index.md)
- [Examples](https://docs.graphy.dev/data-import-utils/examples.md)
- [Licence & evaluation](https://docs.graphy.dev/licence/evaluation.md)
- [File](https://docs.graphy.dev/data-import-utils/file.md)
- [URL](https://docs.graphy.dev/data-import-utils/url.md)
- [Text](https://docs.graphy.dev/data-import-utils/text.md)
- [Buffer](https://docs.graphy.dev/data-import-utils/buffer.md)
- [CSV](https://docs.graphy.dev/data-import-utils/csv.md)
- [TSV](https://docs.graphy.dev/data-import-utils/tsv.md)
- [XLSX](https://docs.graphy.dev/data-import-utils/xlsx.md)
- [XLS](https://docs.graphy.dev/data-import-utils/xls.md)
- [ODS](https://docs.graphy.dev/data-import-utils/ods.md)
- [Quickstart](https://docs.graphy.dev/sdk/core/quickstart.md)
- [Data structure](https://docs.graphy.dev/sdk/core/data-structure.md)
- [Overview](https://docs.graphy.dev/sdk/graph-types/index.md)
- [Line](https://docs.graphy.dev/sdk/graph-types/line.md)
- [Stacked area](https://docs.graphy.dev/sdk/graph-types/area-stacked.md)
- [Bar](https://docs.graphy.dev/sdk/graph-types/bar.md)
- [Column](https://docs.graphy.dev/sdk/graph-types/column.md)
- [Combo](https://docs.graphy.dev/sdk/graph-types/combo.md)
- [Pie](https://docs.graphy.dev/sdk/graph-types/pie.md)
- [Donut](https://docs.graphy.dev/sdk/graph-types/donut.md)
- [Funnel](https://docs.graphy.dev/sdk/graph-types/funnel.md)
- [Heatmap](https://docs.graphy.dev/sdk/graph-types/heatmap.md)
- [Scatter](https://docs.graphy.dev/sdk/graph-types/scatter.md)
- [Bubble](https://docs.graphy.dev/sdk/graph-types/bubble.md)
- [Waterfall](https://docs.graphy.dev/sdk/graph-types/waterfall.md)
- [Mekko](https://docs.graphy.dev/sdk/graph-types/mekko.md)
- [Table](https://docs.graphy.dev/sdk/graph-types/table.md)
- [Custom appearance](https://docs.graphy.dev/sdk/customisation/custom-appearance.md)
- [Series colors](https://docs.graphy.dev/sdk/customisation/series-colors.md)
- [CSS hooks](https://docs.graphy.dev/sdk/customisation/css-hooks.md)
- [Graph fonts](https://docs.graphy.dev/sdk/customisation/graph-fonts.md): Customize the font families in your graphs
- [Graph borders](https://docs.graphy.dev/sdk/customisation/graph-borders.md)
- [Type options](https://docs.graphy.dev/sdk/config/type-options.md)
- [Axes](https://docs.graphy.dev/sdk/config/axes.md)
- [Legend](https://docs.graphy.dev/sdk/config/legend.md)
- [Appearance](https://docs.graphy.dev/sdk/config/appearance.md)
- [Content](https://docs.graphy.dev/sdk/config/content.md)
- [Headline numbers](https://docs.graphy.dev/sdk/config/headline-numbers.md)
- [Data labels](https://docs.graphy.dev/sdk/config/data-labels.md)
- [Reference lines](https://docs.graphy.dev/sdk/config/reference-lines.md)
- [Annotations](https://docs.graphy.dev/sdk/config/annotations.md)
- [Editor quick start](https://docs.graphy.dev/sdk/editor/index.md)
- [Editor panels](https://docs.graphy.dev/sdk/editor/editor-panels.md): Easy-to-use panels to change how your graph looks and works
- [Data table](https://docs.graphy.dev/sdk/editor/data-table.md)
- [Graph type icon](https://docs.graphy.dev/sdk/editor/graph-type-icon.md)
- [Internationalization](https://docs.graphy.dev/sdk/advanced/i18n.md)
- [Error handling](https://docs.graphy.dev/sdk/advanced/error-handling.md)
- [Portal provider](https://docs.graphy.dev/sdk/advanced/portal-provider.md)
- [Version management](https://docs.graphy.dev/sdk/advanced/versioning.md)
- [Graph](https://docs.graphy.dev/sdk/reference/graph.md)
- [GraphConfig](https://docs.graphy.dev/sdk/reference/graph-config.md)
- [GraphProvider](https://docs.graphy.dev/sdk/reference/graph-provider.md)
- [GraphTheme](https://docs.graphy.dev/sdk/reference/graph-theme.md)
- [EditorProvider](https://docs.graphy.dev/sdk/reference/editor-provider.md)
- [EditorTheme](https://docs.graphy.dev/sdk/reference/editor-theme.md)
- [EditorComponentRegistry](https://docs.graphy.dev/sdk/reference/editor-component-registry.md)

## OpenAPI Specs

- [openapi](/agents/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.