depot_list_projects
List projects
List the organization's Depot projects. A project is an isolated container-build cache (region, hardware, cache policy). Use the returned projectId with the build and registry tools. Depot: ProjectService/ListProjects.
Parameterspage_sizeregion_idpage_token
depot_get_project
Get a project
Get one Depot project — name, region, hardware size, cache policy, build timeout and autoscaling. Depot: ProjectService/GetProject.
Parametersproject_idrequired
depot_list_builds
List builds for a project
List container builds in a project, newest first: status (STATUS_RUNNING / FAILED / SUCCESS / ERROR / CANCELED), timestamps, build duration, time saved by cache, and cached vs total steps. Depot: core BuildService/ListBuilds.
Parameterspage_sizepage_tokenproject_idrequired
depot_get_build
Get a build
Get one container build's status, timestamps, duration, time saved and cached/total step counts. Depot: core BuildService/GetBuild.
Parametersbuild_idrequired
depot_get_build_steps
List a build's steps
List the BuildKit steps of a container build: name, digest, start/end time, cache state (CACHED / UNCACHED), any error, and whether it has logs. Find the failing step here, then pass its digest to depot_get_build_step_logs. Depot: build.v1 BuildService/GetBuildSteps.
Parametersbuild_idrequiredpage_sizepage_tokenproject_idrequired
depot_get_build_step_logs
Get a build step's logs
Get the log lines (message + timestamp) of one container-build step, identified by its digest from depot_get_build_steps. Depot: build.v1 BuildService/GetBuildStepLogs.
Parametersbuild_idrequiredpage_sizepage_tokenproject_idrequiredstep_digestrequired
depot_list_registry_images
List registry images
List the images stored in a project's Depot Registry: tag, digest, pushedAt and sizeBytes. Depot: build.v1 RegistryService/ListImages.
Parameterspage_sizepage_tokenproject_idrequired
depot_get_usage
Get organization usage
Get the organization's Depot usage over a window: container builds per project (build count, minutes saved, minutes billed), GitHub Actions jobs per repo/workflow/runner (minutes elapsed and billed), storage, and agent sandboxes. Depot: UsageService/GetUsage.
Parametersend_atrequiredstart_atrequired
depot_ci_list_runs
List Depot CI runs
List Depot CI runs, newest first. Filter by status (default: running + queued — pass ["failed"] to find failures), repo, commit SHA prefix, trigger event, or pull request number (requires repo). Depot: CIService/ListRuns.
Parametersprsharepostatustriggerpage_sizepage_token
depot_ci_get_run_status
Get a CI run's status tree
Get a Depot CI run's status with its nested workflows, jobs and attempts (ids, keys, statuses, error messages). This is how to find the workflowId / jobId / attemptId for the log, diagnosis and retry tools. Depot: CIService/GetRunStatus.
Parametersrun_idrequired
depot_ci_list_workflows
List Depot CI workflows
List Depot CI workflows across runs, newest first, with per-status job counts. Filter by name/path text, repo, status, trigger, SHA prefix or PR number. Depot: CIService/ListWorkflows.
Parametersprshanamerepostatustriggerpage_size
depot_ci_get_job
Get a CI job
Get one Depot CI job: status, conclusion, error message, timestamps, runner config (labels, image, CPUs, memory), matrix values, parent run/workflow context, dependencies and attempt history. Depot: CIService/GetJob.
Parametersjob_idrequired
depot_ci_get_job_logs
Get a CI job's logs
Get persisted log lines for a Depot CI job attempt, oldest first (step key/name, timestamp, line number, body). Pass job_id to read the job's latest attempt, or attempt_id for a specific one — exactly one. Pass nextPageToken back as page_token for more lines. Depot: CIService/GetJobAttemptLogs.
Parametersjob_idattempt_idpage_token
depot_ci_get_failure_diagnosis
Diagnose a CI failure
Get Depot's failure diagnosis for a CI run, workflow, job or attempt. For runs and workflows, identical failures are grouped by error fingerprint; for a job or attempt it is a focused diagnosis with evidence. Empty when no failure evidence is found. The best first call when a run failed. Depot: CIService/GetFailureDiagnosis.
Parameterstarget_idrequiredtarget_typerequired
depot_gha_list_jobs
List GitHub Actions jobs on Depot runners
List GitHub Actions jobs that ran on Depot-managed runners, newest first: status, conclusion, runner label, requested CPU/memory, duration, billable time and GitHub URL. Defaults to the last 30 days (max window 90 days). Depot: GithubActionsService/ListGithubActionsJobs.
Parametersqueryend_atstart_atstatusespage_sizepage_tokenconclusionsrepositoriesrunner_labels
depot_gha_search_logs
Search GitHub Actions logs
Search GitHub Actions log lines from Depot runners, newest match first (job, workflow, step, timestamp, body, lineId). Defaults to the last hour (max window 30 days). Filter by repository, workflow, runner label, action or compute id. Depot: GithubActionsService/SearchGithubActionsLogs.
Parametersqueryend_atactionsstart_atpage_sizeworkflowscompute_idpage_tokenrepositoriesrunner_labels
depot_gha_get_analytics
Get GitHub Actions analytics
Get time-bucketed GitHub Actions analytics for Depot runners: job counts (successful/failed/cancelled), failure rate, elapsed and billable seconds, average duration — as totals plus hourly or daily buckets. Defaults to the last 30 days (max 90). Depot: GithubActionsService/GetGithubActionsAnalytics.
Parametersjobsend_atstart_atworkflowsrepositoriesrunner_labelsworkflow_pathsaggregation_unit
depot_gha_list_recommendations
List runner-size recommendations
List Depot's runner-size recommendations from job CPU and memory metrics: SIZE_UP when average CPU or memory reaches 90%, SIZE_DOWN when both averages stay ≤30% and peaks ≤70%, with current vs suggested size and per-minute price. Defaults to the last 30 days. Depot: GithubActionsService/ListGithubActionsRecommendations.
Parametersjobsend_atstart_atpage_sizeworkflowspage_tokenrepositoriesrunner_labelsworkflow_paths
depot_cache_list_entries
List cache entries
List Depot Cache entries of one type, optionally by key prefix: key, size in bytes, name and creation time (Depot returns no last-access time and no repository). Retention and size limits are set only in the dashboard (Organization Settings), not through the API. Depot: CacheService/ListEntries on cache.depot.dev.
Parameterspage_sizeentry_typerequiredkey_prefixpage_token
depot_cache_delete_entries
Delete cache entries
WRITE — deletes cached build data; a later build rebuilds it. Delete Depot Cache entries by exact key. Without confirm it only previews: it shows which keys exist, with their size, and deletes nothing. Show the preview to the user, then call again with confirm: true. Depot: CacheService/DeleteEntry on cache.depot.dev.
Parameterskeysrequiredconfirmentry_typerequired
depot_create_project
Create a project
WRITE. Create a Depot container-build project (an isolated build cache). Idempotent by name: if an active project with the same name exists, that project is returned. Defaults: cache 50 GB / 14 days, hardware HARDWARE_16X32 on AWS builders. Depot: ProjectService/CreateProject.
Parametersnamerequiredhardwareregion_idrequiredcache_keep_gbcache_keep_daysorganization_idbuild_timeout_minutesmax_concurrent_builds
depot_ci_retry_job
Retry a CI job
WRITE — starts compute. Retry one failed or cancelled Depot CI job, plus any skipped jobs that depend on it. Fails if a dependent job already started; use depot_ci_retry_failed_jobs then. Depot: CIService/RetryJob.
Parametersjob_idrequiredworkflow_idrequired
depot_ci_retry_failed_jobs
Retry a workflow's failed jobs
WRITE — starts compute. Retry only the failed and cancelled jobs in a Depot CI workflow, plus skipped jobs that depend on them. Jobs that succeeded are left alone. Depot: CIService/RetryFailedJobs.
Parametersworkflow_idrequired
depot_ci_cancel_run
Cancel a CI run
WRITE — stops work in progress. Cancel a queued or running Depot CI run and all of its unfinished workflows, jobs and attempts. Cancelled jobs can be retried afterwards with depot_ci_retry_failed_jobs. Depot: CIService/CancelRun.
Parametersrun_idrequired