audit-logs
--limit entries (default 20) across the full history by default. Use --start/--end or --since to scope the time window, and the filter flags (--event-type-group, --source, --user-id, --deployment-id, --environment, --search) to narrow results.
For machine-readable streaming, prefer --output jsonl over --output json.
Options
Only return entries referencing one of these model deployment IDs. May be repeated.
Sort order by the time the action occurred: ‘desc’ (newest first) or ‘asc’ (oldest first).One of:
asc, descEnd of the time window. Accepts ISO 8601; values without a timezone designator are interpreted in the local timezone. Defaults to now.
Only return entries whose event type falls in one of these groups. May be repeated. One of: activated-deactivated, api-keys, autoscaling-settings, deleted, deployed, directory-group-management, environment-settings, gateway, instance-type-changed, promoted, replica-terminated, secrets, ssh, user-management, webhook-signing-secrets.
Maximum number of entries to return, paging as needed. Use 0 for no limit (every entry in the window).
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Shortcut for a window from a relative time ago until now. Accepts a duration (e.g. ‘30m’, ‘1h30m’) or ‘
Nd’ (e.g. ‘3d’). Mutually exclusive with --start and --end.Only return entries issued from one of these surfaces. May be repeated. One of: ui, api, mcp, other.
Start of the time window. Accepts ISO 8601 (e.g. ‘2026-05-14’, ‘2026-05-14T12:00:00’, ‘2026-05-14T12:00:00Z’). Values without a timezone designator are interpreted in the local timezone. Defaults to the beginning of the audit-log history.
Examples
List the 20 most recent audit-log entriesFilter output with --jq
Stream each entry’s event type as a JSONL stream
Output
Text mode (--output text): Table with columns: TIME, ACTOR, EVENT, SOURCE. When no entries match, prints “No audit-log entries found.” to stderr.
JSON mode (--output json): payload type managementapi.AuditLogEntry.
describe
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Examples
Describe the organizationFilter output with --jq
Print just the organization ID
Output
Text mode (--output text): Field-per-line summary: org ID, name (when set), and the AWS AssumeRole role ARN and external ID (if enabled).
JSON mode (--output json): payload type managementapi.OrganizationInfo.
regions
baseten model push --region.
Pass --team to list the regions available to one team instead, which may be a subset of the organization’s.
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
List the regions available to this team by name or ID, instead of the organization’s. Run ‘baseten org team list’ to see teams.
Examples
List the organization’s regionsFilter output with --jq
Print just the region slugs
Output
Text mode (--output text): Table with columns: SLUG, NAME. When the organization has no regions, prints “No regions found.” to stderr.
JSON mode (--output json): payload type managementapi.Regions.
api-key
API keys authenticate requests to the Management API and to model inference. The list includes Grid API keys; pass--type grid to list only those.
list
--type grid to list only Grid keys, including the ones baseten grid setup creates for coding agents.
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Only list keys of this category.One of:
personal, workspace-export-metrics, workspace-invoke, workspace-manage-all, workspace-manage-api-keys, gridExamples
List the API keys you can manage:Filter output with --jq
Print just the prefixes of personal keys
Output
Text mode (--output text): Table with columns: NAME, KEY (prefix + ****), TYPE, TEAM, CREATED, LAST USED, and EXPIRES. Expirations are UTC RFC 3339 timestamps, or never for keys with no scheduled expiration. Personal keys without an expiration can still be revoked for inactivity. When no keys exist, the CLI prints “No API keys found.” to stderr.
JSON mode (--output json): payload type managementapi.APIKeys.
create
--model-id for each allowed model. Use model restrictions only with --type workspace-export-metrics or --type workspace-invoke. --type grid creates a personal Grid key in --team; its usage counts against your Grid budget in that team.
Options
Expiration time as a future ISO 8601 timestamp, such as
2027-01-15T00:00:00Z. Values without a time zone use your local time zone. Personal keys must expire within 90 days or your organization’s shorter limit. For team and API key management keys, omit this flag only when the organization allows keys without an expiration. Manage key expiration.Restrict the key to a specific model. May be repeated. Only valid with
--type workspace-export-metrics or workspace-invoke.Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Team name or ID to create the key in. Defaults to the organization’s default team. Run ‘baseten org team list’ to see teams.
API key category.One of:
personal, workspace-export-metrics, workspace-invoke, workspace-manage-all, workspace-manage-api-keys, gridExamples
Create a personal API key with an expiration. Replace<expires-at> with a future ISO 8601 timestamp within the expiration limit, such as 2027-01-15T00:00:00Z:
<id-1> and <id-2> with the allowed model IDs and run the following command:
Filter output with --jq
Print the raw key value as a JSON string:
Output
Text mode (--output text): Prints the raw API key value on stdout (one line). Also prints “Save this key now. It will not be shown again.” to stderr.
JSON mode (--output json): payload type managementapi.APIKey.
delete
--name or --prefix is required: --name matches the human-readable name, --prefix matches the leading characters shown in org api-key list.
Options
Human-readable name of the API key to delete.Mutually exclusive with other flags in group
identifier.Prefix of the API key to delete (as shown in list).Mutually exclusive with other flags in group
identifier.Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Examples
Delete an API key by nameFilter output with --jq
Print just the deleted key’s prefix
Output
Text mode (--output text): Prints “Deleted API key prefix” to stderr on success; no stdout output.
JSON mode (--output json): payload type managementapi.APIKeyTombstone.
billing
The usage summary breaks spending down by dedicated deployments, model APIs, and training.usage
--since (relative duration, e.g. 7d, 24h) for a sliding window ending now, or --start and --end together for an explicit ISO 8601 range. The two modes are mutually exclusive. The range cannot exceed 31 days and cannot start before 2026-01-01 UTC. Defaults to --since 7d.
Options
End of the window. Accepts ISO 8601; values without a timezone are interpreted in the local timezone. Requires
--start. Mutually exclusive with --since.Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Relative window ending now (e.g. 24h, 7d). Used when neither
--start nor --end is given. Maximum 31d. Mutually exclusive with --start/--end.Start of the window. Accepts ISO 8601 (e.g. ‘2026-05-01’, ‘2026-05-01T12:00:00Z’); values without a timezone are interpreted in the local timezone. Requires
--end. Mutually exclusive with --since.Examples
Show usage over the last 7 days (default)Filter output with --jq
Print the total cost of model API usage
Output
Text mode (--output text): The resolved window on stderr, then a table on stdout with one row per category present (Dedicated, Model APIs, Training), plus an “All” total row when more than one category is present, with columns CATEGORY, MINUTES, TOTAL, CREDITS, SUBTOTAL. Costs are in USD; SUBTOTAL is the net cost after credits. Prints “No usage in the selected window.” to stderr when every category is absent.
JSON mode (--output json): payload type managementapi.UsageSummary.
The usage summary: optional dedicated_usage, model_apis_usage, and training_usage objects, each with total/credits_used/subtotal costs and a per-resource breakdown whose items each carry an optional daily series.
secret
Secrets hold values that deployments and training jobs read at runtime. Set, list, and delete them.list
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Examples
List secrets across all accessible teamsFilter output with --jq
Print just the secret names
Output
Text mode (--output text): Table with columns: NAME, TEAM, CREATED. When no secrets exist, prints “No secrets found.” to stderr.
JSON mode (--output json): payload type managementapi.Secrets.
set
--value is supported but discouraged: it leaks the secret into shell history and ps output. Pass --team to target a specific team; without it the organization’s default team is used.
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Team name or ID the secret belongs to. Defaults to the organization’s default team. Run ‘baseten org team list’ to see teams.
Examples
Set a secret by piping its value through stdinFilter output with --jq
Print the secret’s team
Output
Text mode (--output text): Prints “Set secret name” to stderr on success; no stdout output.
JSON mode (--output json): payload type managementapi.Secret.
delete
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Team name or ID the secret belongs to. Defaults to the organization’s default team. Run ‘baseten org team list’ to see teams.
Examples
Delete a secret by nameFilter output with --jq
Print just the deleted secret name
Output
Text mode (--output text): Prints “Deleted secret name” to stderr on success; no stdout output.
JSON mode (--output json): payload type managementapi.SecretTombstone.
team
List and inspect the teams in the organization.describe
--team-id or --team-name.
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Examples
Describe a team by IDFilter output with --jq
Print the team’s name
Output
Text mode (--output text): Field-per-line summary of the team.
JSON mode (--output json): payload type managementapi.Team.
list
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Examples
List all teams in the orgFilter output with --jq
Print just the team names
Output
Text mode (--output text): Table with columns: ID, NAME, DEFAULT, CREATED. When no teams exist, prints “No teams found.” to stderr.
JSON mode (--output json): payload type managementapi.Teams.
user
List and inspect the users in the organization.describe
--user-id or --user-email. Pass --user-id me for the authenticated user.
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
User ID to describe. Pass ‘me’ for the authenticated user.Mutually exclusive with other flags in group
user-ref.Examples
Describe the authenticated userFilter output with --jq
Print the user’s email
Output
Text mode (--output text): Field-per-line summary of the user.
JSON mode (--output json): payload type managementapi.UserInfo.
list
Options
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
Examples
List all users in the orgFilter output with --jq
Print just the user emails
Output
Text mode (--output text): Table with columns: USER ID, EMAIL, NAME. When no users exist, prints “No users found.” to stderr.
JSON mode (--output json): payload type cmd.OrgUserList.