{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","callout","faq","faq-item","partial"]},"type":"markdown","userRole":"Admins","accountType":"All accounts","plan":"Exclusive to select subscription plans"},"seo":{"title":"Manage Databox using the CLI","description":"Use the Databox CLI to manage accounts, data sources, datasets, and AI analysis from your terminal or automated pipelines.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"manage-databox-using-the-cli","__idx":0},"children":["Manage Databox using the CLI"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"admins","accounts":"all","plans":"exclusive"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Development workflows rarely stay in the browser. Teams managing data pipelines, CI/CD processes, or scripted automation need to interact with Databox without switching context. The Databox CLI brings the full platform into your terminal — letting you create data sources, ingest records, query datasets with AI, and manage accounts alongside the rest of your developer tooling. It also ships with installable agent skills, so AI coding assistants like Claude Code can manage your Databox account autonomously."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"install-the-cli","__idx":1},"children":["Install the CLI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Databox CLI requires ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Node.js 18 or higher"]},". Install it globally via npm:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npm install -g databox-cli\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To verify the installation:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox --version\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authenticate","__idx":2},"children":["Authenticate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All CLI commands authenticate using a Databox API key. The key is stored locally at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.config/databox-cli/config.json"]}," and sent as an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-api-key"]}," header over HTTPS."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Generate an API key in your Databox account. Follow the steps on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.databox.com/docs/api/authentication"},"children":["Authentication page"]}," in the Databox API documentation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run the login command:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox auth login\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll be prompted to enter your API key interactively. To pass it inline instead:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox auth login --api-key YOUR_API_KEY\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate that the key is stored correctly:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox auth validate\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["API keys are scoped to your account permissions. Commands that require higher access levels will fail if the key belongs to a user without the appropriate role."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"manage-accounts","__idx":3},"children":["Manage accounts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use account commands to explore what's available in your Databox account before creating or ingesting data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View accessible accounts:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox account list\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List data sources in an account:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox account data-sources ACCOUNTID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List datasets in an account:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox account datasets ACCOUNTID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supports optional flags for filtering by type and paginating large result sets."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View supported time zones:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox account timezones\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"manage-data-sources","__idx":4},"children":["Manage data sources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/add-a-data-source"},"children":["data source"]}," is a logical container for one or more datasets. Create ]one before defining your dataset structure."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a data source:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox data-source create --title \"Production Metrics\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supports optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--timezone"]}," and key flags. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox account timezones"]}," to see valid timezone values."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List datasets under a data source:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox data-source datasets DATASOURCEID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete a data source:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox data-source delete DATASOURCEID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"warning"},"children":["Deleting a data source is irreversible and removes all associated datasets and their data. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--force"]}," to skip the confirmation prompt in automated scripts."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"manage-datasets","__idx":5},"children":["Manage datasets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-datasets"},"children":["Datasets"]}," are structured tables that hold your records. Define the schema and primary keys at creation time — these determine how incoming records are validated and how duplicates are handled."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a dataset:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox dataset create --data-source-id DATASOURCEID --title \"Daily Revenue\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supports optional schema definitions and primary key flags."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retrieve dataset details:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox dataset get DATASETID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ingest records into a dataset:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox dataset ingest DATASETID --file ./records.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accepts data from a file path, inline JSON, or piped stdin — making it easy to wire into existing scripts and pipelines:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"cat records.json | databox dataset ingest DATASETID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View ingestion history:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox dataset ingestions DATASETID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inspect a specific ingestion:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox dataset ingestion DATASETID INGESTIONID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Purge all data from a dataset (keep the schema):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox dataset purge DATASETID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete a dataset entirely:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox dataset delete DATASETID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"warning"},"children":["Purge and delete are irreversible. Both require explicit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--force"]}," or interactive confirmation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"analyze-data-with-genie","__idx":6},"children":["Analyze data with Genie"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/get-started-with-genie-the-databox-ai-assistant"},"children":["Genie"]}," lets you query any dataset using natural language from the terminal. Answers are computed by Databox's analytics engine — not generated by an LLM — so the results reflect your actual data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ask a question:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox analyze ask-genie DATASETID \"What was the total revenue last month?\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Responses stream in real time. To continue a conversation, pass the thread ID returned by the first response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox analyze ask-genie DATASETID \"How does that compare to the month before?\" --thread THREADID\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-the-cli-with-ai-agents","__idx":7},"children":["Use the CLI with AI agents"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The CLI ships with five modular agent skills covering authentication, accounts, data sources, datasets, and analysis. Install them via:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npx skills add databox/databox-cli\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once installed, AI coding assistants — including Claude Code and Cursor — can autonomously manage your Databox account: creating data sources, ingesting records, querying datasets, and more."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"output-formats","__idx":8},"children":["Output formats"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every command returns human-readable formatted tables by default. Add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--json"]}," to any command for machine-readable output suitable for scripts, pipelines, or downstream processing:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"databox account list --json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"command-reference","__idx":9},"children":["Command reference"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"table-header","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Command"},"children":["Command"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox auth login"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authenticate with your API key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox auth validate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate the stored API key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox account data-sources ACCOUNTID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List data sources in an account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox account datasets ACCOUNTID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List datasets in an account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox account list"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List accessible accounts"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox account timezones"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List supported time zones"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox analyze ask-genie DATASETID QUESTION"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query a dataset using natural language"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox data-source create --title <value>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a new data source"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox data-source datasets DATASOURCEID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List datasets under a data source"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox data-source delete DATASOURCEID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete a data source"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox dataset create --data-source-id <value> --title <value>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a new dataset"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox dataset delete DATASETID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete a dataset"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox dataset get DATASETID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve dataset details"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox dataset ingest DATASETID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ingest records via file, JSON, or stdin"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox dataset ingestion DATASETID INGESTIONID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inspect a specific ingestion"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox dataset ingestions DATASETID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List ingestion history for a dataset"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databox dataset purge DATASETID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clear all data from a dataset"]}]}]}]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Can I use the CLI in CI/CD pipelines and automated scripts?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes. Every command supports the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--json"]}," flag for machine-readable output, and destructive commands accept ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--force"]}," to skip interactive confirmation prompts — making the CLI suitable for fully automated environments."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Does the CLI work on Windows?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes. The CLI is an npm package and runs on any platform where Node.js 18+ is supported, including Windows, macOS, and Linux."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"How do I update the CLI?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npm update -g databox-cli"]}," to install the latest version. Because all business logic runs on Databox's servers, most new features and improvements do not require a client update."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Is my API key stored securely?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The key is stored in a local config file at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.config/databox-cli/config.json"]},". It is transmitted only as an HTTPS header to Databox's servers. Treat this file like any other credential — avoid committing it to version control."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"What happens if I ingest duplicate records?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Duplicate handling depends on the primary keys defined when the dataset was created. Records matching an existing primary key overwrite the existing entry; records with unique primary keys are appended as new rows."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Manage Databox using the CLI","id":"manage-databox-using-the-cli","depth":1},{"value":"Install the CLI","id":"install-the-cli","depth":2},{"value":"Authenticate","id":"authenticate","depth":2},{"value":"Manage accounts","id":"manage-accounts","depth":2},{"value":"Manage data sources","id":"manage-data-sources","depth":2},{"value":"Manage datasets","id":"manage-datasets","depth":2},{"value":"Analyze data with Genie","id":"analyze-data-with-genie","depth":2},{"value":"Use the CLI with AI agents","id":"use-the-cli-with-ai-agents","depth":2},{"value":"Output formats","id":"output-formats","depth":2},{"value":"Command reference","id":"command-reference","depth":2}],"frontmatter":{"slug":"manage-databox-using-the-cli","seo":{"title":"Manage Databox using the CLI","description":"Use the Databox CLI to manage accounts, data sources, datasets, and AI analysis from your terminal or automated pipelines."},"keywords":{"includes":["Databox CLI","databox-cli npm","Databox command line","push data to Databox terminal","Databox CLI commands","Databox CLI installation","Databox CLI authentication","Databox CLI dataset ingest","Databox CLI Genie","Databox CLI agent skills"]},"metadata":{"userRole":"Admins","accountType":"All accounts","plan":"Exclusive to select subscription plans"}},"lastModified":"2026-06-05T09:50:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/manage-databox-using-the-cli","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}