# Settings and API keys Manage the operational side of your workspace: plan usage, billing, seats, storage, and the SDK keys your training jobs authenticate with. ## Open Workspace settings Settings is a centered **Workspace settings** modal, not a nav-rail tab. To open it: 1. Click your account menu in the top-right of the dashboard. 2. Choose **Workspace settings**. The modal has six sections: **Plan Usage**, **Billing**, **Seats**, **Workspace**, **API**, and **Defaults**. It is scoped to the active workspace — the account menu shows which workspace is current, so confirm it before inviting teammates or changing billing. See [Organizations and workspaces](/docs/dashboard/organizations-workspaces.md) for the workspace hierarchy and role model. ## Check plan usage The topbar shows a compact plan usage badge. The **Plan Usage** section shows more detail: - Current plan. - **Metric points this month** — usage for the current UTC calendar month. - **API requests this month** — usage for the current UTC calendar month. - **General API rate** and **Ingest API rate** policies. - **Monthly reset** — the next UTC reset time. - Seat usage, storage usage, and accounting notes. Metric-point and API-request usage reset monthly. Free-plan API request overage is blocked; paid Pro/Premium overage is metered through Stripe. Storage and seats measure what you currently hold, so they do not reset monthly. ## Manage billing The **Billing** section handles plan changes through hosted billing flows. It exposes plan upgrade/downgrade actions, **Open portal** for the Stripe customer portal, and **Cancel subscription**, where your workspace role allows it. When a workspace is pending payment or payment-failed, write routes can return a payment-required error until billing recovers. ## Manage seats and invitations From the **Seats** section, admins can invite teammates, resend pending invitations, revoke pending invitations, and see seat accounting that includes active members plus unexpired pending invitations. Owners and admins can manage seats. Members can write runs, artifacts, reports, and saved views. Viewers can inspect dashboard data but cannot change anything. ## Create API keys SDK keys are managed in the **API** section of the Workspace settings modal. Owners and admins can create a copy-once key by name, copy it while it is visible, see active and revoked keys with their prefixes, and revoke keys that should no longer be used. An **API reference** link at the bottom opens the generated route reference. To connect a coding agent over MCP, use the [Agent tab](/docs/dashboard/api-tab.md) in the nav rail — its setup snippets fill in a key you created here, or use browser sign-in with no key at all. > **Warning:** Copy a new key immediately when it is revealed. InstantML stores only a hash after creation, so the plaintext key cannot be recovered later. Store keys in environment variables or a secrets manager: ```bash export INSTANTML_API_KEY="instantml_..." ``` Use the key for SDK runs: ```python import instantml as im run = im.init(project="demo") run.log({"accuracy": 0.94, "loss": 0.18}, step=10) run.finish() ``` Or for direct automation: ```bash curl https://api.instantml.ai/projects \ -H "Authorization: Bearer $INSTANTML_API_KEY" ``` Never commit API keys, session cookies, Clerk secrets, ClickHouse credentials, or storage credentials. ## Choose a storage mode Hosted artifact bytes can use InstantML-owned storage. Customer-owned ClickHouse setup is handled in onboarding for Premium teams that need to route product data to their own self-hosted GCP ClickHouse deployment. Dashboard and API-key access remain locked until the storage state is ready. Workspace settings shows storage usage and accounting notes for the active workspace, but the ClickHouse connection form lives in onboarding rather than settings. ## Next steps - [Agent tab](/docs/dashboard/api-tab.md) - [Onboarding, team, and billing](/docs/dashboard/onboarding-team-billing.md) - [Organizations and workspaces](/docs/dashboard/organizations-workspaces.md) - [Pricing, limits, and billing](/docs/guides/pricing-limits-billing.md) - [Customer-owned ClickHouse](/docs/guides/customer-owned-clickhouse.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) (current page) - [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) - [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)