Skip to main content
Logs and Builds help agents repair failed deploys without dashboard clicks. Use them after tovuk check, tovuk deploy --dry-run, and deploy attempts.

​
Deploy diagnostics workflow

1

Check before creating a build

tovuk check --json
tovuk deploy --dry-run --json
Fix the first failed agent_instruction before creating another build. Review dry-run warnings, enabled capabilities, meters, limits, and billing estimates before deploy.
2

Deploy and keep the returned ids

tovuk deploy --wait --json
tovuk deploy list --json
tovuk deploy show deploy_1 --json
Read the returned build_job.id, final_build.status, and deploy id from the deploy output or deploy history. Keep those ids with the failing command.
3

Inspect build and runtime logs

tovuk logs --build build_1 --json
tovuk logs --deploy deploy_1 --json
tovuk logs --service service_1 --json
Read the first actionable log error before changing code. Use build logs for build failures, deploy logs for one deploy, and service logs for latest runtime output.
4

Cancel superseded queued work

tovuk deploy cancel deploy_1 --json
Cancel only queued deploy work that a newer deploy has replaced.
5

Repair and redeploy

tovuk check --json
tovuk deploy --wait --json
Rerun checks after the fix, then redeploy with the same command once the first issue is resolved.

​
Dashboard

The dashboard Activity view is available at https://tovuk.com/account/activity or https://tovuk.com/<handle>/activity. It shows recent deploys, recent builds, runtime logs for a selected Service, next actions, and copyable agent commands. Queued deploy rows can cancel queued build work and expose the same tovuk deploy cancel <deploy_id> --json command. It uses the same activity, deploy cancel, and log API routes, rate limits, and private account auth as the CLI.

​
Agent commands

tovuk deploy list --json
tovuk deploy show deploy_1 --json
tovuk deploy cancel deploy_1 --json
tovuk logs --build build_1 --json
tovuk logs --deploy deploy_1 --json
tovuk logs --service service_1 --json

​
API

  • GET /v1/account/activity
  • GET /v1/deploys/{deploy_id}
  • POST /v1/deploys/{deploy_id}/cancel
  • GET /v1/deploys/{deploy_id}/logs
  • GET /v1/builds/{build_id}/logs
  • GET /v1/services/{service_id}/logs

​
Meters and caps

Builds use build_minutes. Logs use log_events. 
tovuk limits set build_minutes --period month --value 6000 --notify-at-percent 80 --json
tovuk limits set log_events --period month --value 1000000 --notify-at-percent 80 --json

​
Rules

  • Run tovuk check --json before deploying.
  • Read the first actionable log error before making changes.
  • Cancel superseded queued deploys.
  • Include build id, deploy id, failing command, and first actionable log line in support tickets.
Last modified on June 3, 2026