# Export, usage, and limits Export your workspace data, read your current usage, and know exactly what happens when a plan limit is hit. ## Export run data Use `GET /api/export` to retrieve a bounded JSON or CSV export for the current workspace and project context. Filtered exports use the same run filters and search language as `GET /runs`; selected-run exports pass `run_ids` (or `runs`) with up to 100 run UUIDs. Add `format=csv` for a flat spreadsheet-safe record stream. In the dashboard, the Runs command bar uses this route for selected-run CSV downloads. Typical export contents include: - Projects. - Runs. - Scalar metric history. - Attributes and rich object metadata. - Artifact metadata. - Import records. - Limit/truncation metadata. Use export for backups, migrations, debugging, and vendor evaluation. Synchronous exports are capped: | Export cap | Limit | | --- | --- | | Filtered runs | 500 | | Selected run IDs | 100 | | Metric points | 100,000 | | Metric-series summaries | 25,000 | | Attributes | 25,000 | | Artifacts | 10,000 | | Table rows | 25,000 | | Import records | 500 | | CSV response size | 25 MiB | > **Note:** Treat `truncated: true` or `X-InstantML-Export-Truncated: true` as a signal to narrow filters before using the export as a complete archive. ## Export charts Metrics and Runs workspace line charts include opt-in export buttons for the visible graph. Chart CSV export is the plotted sample, not a full raw-history archive; SVG image export renders the visible graph in the browser. These controls are capped at 120 series and 20,000 plotted points. Use selected-run CSV export or filtered API export when you need raw run data. ## Check usage Use `GET /api/usage` to inspect plan catalog data, current workspace usage, limits, and overage policy. Usage includes: - Seats. - Projects. - Runs. - Current-period metric points. - Current-period API requests. - Retained metric points. - Metric series. - Artifacts. - API keys. - Artifact bytes and metadata estimates. ## Know which counters reset Some counters reset every month; others count everything your workspace retains. | Counter | Reset behavior | | --- | --- | | Metric points | Current UTC calendar month | | API requests | Current UTC calendar month | | Projects | Retained resource | | Runs | Retained resource | | Seats | Retained resource | | Storage | Retained resource | | Artifacts | Visibility-only retained count | | API keys | Retained resource | ## Handle blocked-at-limit errors When a blocked limit would be exceeded, write routes return a plan-limit error instead of accepting a partial write. Affected write paths can include: - New projects. - New runs. - Metric ingest. - Artifact storage writes. - Imports. - Demo reset. Short-window API request limits return `429` with `Retry-After`, `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` headers. Monthly API request quotas reset at `usage_period.reset_at`: Free and non-billable workspaces are blocked at the allowance, while paid Pro/Premium overage is Stripe-metered. ## Export usage data Use `GET /api/usage/export` when you need versioned usage data for operations or support workflows. ## Next steps - [Pricing, limits, and billing](/docs/guides/pricing-limits-billing.md) - [Import, export, and usage API](/docs/api/import-export-usage.md) - [Errors and limits](/docs/api/errors-and-limits.md) - [Imports](/docs/guides/imports.md) - [Auth, billing, and storage](/docs/guides/auth-billing-storage.md) ## Agent navigation - [Docs index](/llms.txt) - [Full docs bundle](/llms-full.txt) ### Get Started - [Overview](/docs/index.md) - [Quickstart](/docs/quickstart.md) - [Core Concepts](/docs/concepts/core-concepts.md) - [Pricing](/docs/pricing.md) - [Benchmarks](/docs/benchmarks.md) - [Examples](/docs/guides/examples.md) - [Troubleshooting](/docs/troubleshooting.md) ### SDK - [Installation Auth](/docs/sdk/installation-auth.md) - [Logging](/docs/sdk/logging.md) - [Tracing](/docs/sdk/tracing.md) - [Metrics Steps](/docs/sdk/metrics-steps.md) - [Config Tags Notes](/docs/sdk/config-tags-notes.md) - [Artifacts Checkpoints](/docs/sdk/artifacts-checkpoints.md) - [Rich Objects](/docs/sdk/rich-objects.md) - [Distributed Training](/docs/sdk/distributed-training.md) - [Console System Integrations](/docs/sdk/console-system-integrations.md) - [Reliability](/docs/sdk/reliability.md) - [Cli Login](/docs/sdk/cli-login.md) - [Querying Data](/docs/sdk/querying-data.md) - [Agent Mcp](/docs/sdk/agent-mcp.md) - [Examples Patterns](/docs/sdk/examples-patterns.md) ### Integrations - [Overview](/docs/integrations/overview.md) - [Pytorch Lightning](/docs/integrations/pytorch-lightning.md) - [Huggingface Transformers](/docs/integrations/huggingface-transformers.md) - [Keras](/docs/integrations/keras.md) - [Wandb](/docs/integrations/wandb.md) ### Dashboard - [Tour](/docs/dashboard/tour.md) - [Organizations Workspaces](/docs/dashboard/organizations-workspaces.md) - [Runs Workspace](/docs/dashboard/runs-workspace.md) - [Metrics Charts](/docs/dashboard/metrics-charts.md) - [Run Detail](/docs/dashboard/run-detail.md) - [Traces](/docs/dashboard/traces.md) - [Compare Runs](/docs/dashboard/compare-runs.md) - [Research Dashboards](/docs/dashboard/research-dashboards.md) - [Artifacts Files](/docs/dashboard/artifacts-files.md) - [Run Health](/docs/dashboard/alerts.md) - [Datasets](/docs/dashboard/datasets.md) - [Checkpoints](/docs/dashboard/checkpoints.md) - [Reports](/docs/dashboard/reports.md) - [Settings Api Keys](/docs/dashboard/settings-api-keys.md) - [Api Tab](/docs/dashboard/api-tab.md) - [Onboarding Team Billing](/docs/dashboard/onboarding-team-billing.md) ### Data - [Imports](/docs/guides/imports.md) - [W&B alternative](/docs/guides/wandb-alternative.md) - [InstantML vs MLflow](/docs/guides/instantml-vs-mlflow.md) - [W&B import guide](/docs/guides/wandb-import-guide.md) - [W&B and Neptune imports](/docs/guides/wandb-neptune-imports.md) - [Export Usage Limits](/docs/guides/export-usage-limits.md) (current page) - [Pricing Limits Billing](/docs/guides/pricing-limits-billing.md) - [Auth Billing Storage](/docs/guides/auth-billing-storage.md) - [Customer Owned Clickhouse](/docs/guides/customer-owned-clickhouse.md) - [Observability](/docs/guides/observability.md) ### API **Practical API guides** - [Authentication](/docs/api/authentication.md) - [Errors And Limits](/docs/api/errors-and-limits.md) - [Health Observability](/docs/api/health-observability.md) - [Projects Runs](/docs/api/projects-runs.md) - [Metrics Series](/docs/api/metrics-series.md) - [Attributes Objects](/docs/api/attributes-objects.md) - [Artifacts](/docs/api/artifacts.md) - [Reports](/docs/api/reports.md) - [Iframe Embeds](/docs/api/iframe-embeds.md) - [Import Export Usage](/docs/api/import-export-usage.md) - [Dashboard Control State](/docs/api/dashboard-control-state.md) **Architecture** - [System Overview](/docs/architecture/system-overview.md) - [Service Planes](/docs/architecture/service-planes.md) - [Storage Model](/docs/architecture/storage-model.md) - [Google Clickhouse](/docs/architecture/google-clickhouse.md) - [Auth Tenancy](/docs/architecture/auth-tenancy.md) - [Schema Reference](/docs/architecture/schema-reference.md) ### API Reference - [API Reference](/docs/api-reference.md)