Render GraphViz Diagram

quickchart.render_graphviz
ActionBusiness appsconnection required

Calls the QuickChart API with the connection's credentials.

Render a GraphViz DOT description as a diagram and emit it as a base64 file blob.

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
QuickChart
Secret shape
the API key, or {"api_key": "…"} — optional, since QuickChart's free tier and a self-hosted instance need none
Config it needs
base_url
Resolved by
config.connection_id, else node.connection_id

Configuration

6 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
graph
The graph in GraphViz DOT syntax, such as digraph {a -> b}.
stringYes——digraph { order -> payment -> fulfilment }
layout
GraphViz layout engine to lay the nodes out with.
stringNodotone of "dot", "fdp", "neato", "circo", "twopi", "osage", "patchwork"—
format
File format QuickChart should render the diagram in.
stringNosvgone of "svg", "png"—
width
Width of the rendered image in pixels; applies to PNG output only, and QuickChart fits the graph when it is empty.
numberNo—≥ 1—
height
Height of the rendered image in pixels; applies to PNG output only, and QuickChart fits the graph when it is empty.
numberNo—≥ 1—
filename
Name to give the rendered file on the wire. Defaults to the node's subject and the chosen format, such as chart.png.
stringNo——chart.png

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "filename": "chart.png",
  "format": "svg",
  "graph": "digraph { order -> payment -> fulfilment }",
  "layout": "dot"
}

Output

One shape.

result

FieldTypeExample
file_content
The file, base64-encoded.
string—
content_encoding
stringbase64
filename
stringapp-main.zip
content_type
stringapplication/zip
size
Raw size in bytes (before base64).
number—
{
  "content_encoding": "base64",
  "content_type": "application/zip",
  "file_content": "",
  "filename": "app-main.zip",
  "size": 0
}

See Render GraphViz Diagram run in a workflow.

In a technical demo we add the QuickChart connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.