Skip to main content
Use this page after you are already authenticated with:
tm auth whoami

API Keys

Create a user API key for automation:
USER_ID="$(tm --output json auth whoami | python3 -c 'import json,sys; print(json.load(sys.stdin)["user"]["id"])')"
tm users api-keys create --user-id "$USER_ID" --name ci-key --yes
List existing keys:
 tm --output json users api-keys list
Delete a key explicitly:
tm users api-keys delete --api-key YOUR_KEY --yes

Billing Reads

Check current balance:
 tm --output json billing balance
Read transaction history with explicit pagination:
 tm --output json billing transactions list --page-size 25 --page-token "$NEXT_PAGE_TOKEN"
Read spending summary:
 tm --output json billing spending summary

Support Tickets

Create a ticket:
 tm --output json tickets create --subject "Need help" --message "Please investigate."
Append a follow-up:
 tm --output json tickets message TICKET_ID --message "Following up"
List open tickets:
 tm --output json tickets list --status TICKET_STATUS_OPEN --page 1 --size 20

Logs And Metrics

Fetch recent deployment logs:
tm logs DEPLOYMENT_ID --limit 100 --direction desc
Follow logs continuously:
tm logs DEPLOYMENT_ID --follow --direction asc
Fetch deployment metrics:
 tm --output json metrics deployment DEPLOYMENT_ID --step-seconds 60
Fetch user-level metrics:
 tm --output json metrics user --step-seconds 60

When To Prefer JSON

For anything that feeds another program, prefer --output json and pass pagination or filter values explicitly. Use table or text output only for interactive inspection.