Configuration Reference · Docs

--name, --title, --tags, --public, --private — the full push-time flag surface.

Full push flags

Every flag below can be passed to instadash push. Required flags are --key (or the INSTADASH_KEY env var) and at least one data source (--file, --url, or stdin).

Flag	Default	Description
`--key, -k`	`INSTADASH_KEY` env	API key. Overrides env var.
`--name, -n`	(required)	Grid slug — URL-safe, e.g. `sales-q2`
`--title`	same as `--name`	Human-readable title shown in the UI
`--description, -d`	`""`	Freeform description indexed for mesh search
`--tags`	`[]`	Comma-separated tags: `--tags "sales,q2,2026"`
`--file, -f`	stdin	Path to local file (`.jsonl`, `.json`, `.csv`)
`--url`	—	Remote URL to fetch and ingest
`--path`	—	Dot-path to extract from JSON: `--path results.items`
`--csv`	`false`	Parse as CSV. First row = headers.
`--delimiter`	comma	CSV delimiter: `comma` \| `tab` \| `semicolon`
`--public`	`true`	Publish to mesh (default behavior)
`--private`	`false`	Scope to workspace. Builder+ required.

Example — fully specified push

instadash push \
  --key sk_live_… \
  --name q2-revenue \
  --title "Q2 2026 Revenue" \
  --description "Consolidated revenue across all regions, Q2 2026" \
  --tags "revenue,q2,2026,finance" \
  --file ./revenue.jsonl \
  --public

Env var shorthand

export INSTADASH_KEY=sk_live_…
# --key can now be omitted from every command
instadash push --name q2-revenue --file revenue.jsonl

Note: The MCP server reads INSTADASH_KEY from its env block — the same variable, no duplication needed.