Servers Playground How we check Submit a server

Depot MCP by usefulapi

Working · 2.2 s

io.usefulapi/depotv1.17.0 Domain verified

Inspect Depot builds, CI runs, job logs and Actions runners; retry or cancel CI runs.

Developer Tools Cloud & DevOps

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://depot.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

depot_ci_cancel_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.

run_idstring, required

CI run id, from depot_ci_list_runs.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Depot MCP by usefulapi MCP server | mcptry

Tools (22)

depot_ci_cancel_run

destructive

Argument	Type	Description
run_id*	string	CI run id, from depot_ci_list_runs.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "minLength": 1,
      "description": "CI run id, from depot_ci_list_runs."
    }
  }
}

depot_ci_get_failure_diagnosis

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.

read-only

Argument	Type	Description
target_id*	string	The run, workflow, job or attempt id.
target_type*	string	What target_id identifies.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "target_type",
    "target_id"
  ],
  "properties": {
    "target_id": {
      "type": "string",
      "minLength": 1,
      "description": "The run, workflow, job or attempt id."
    },
    "target_type": {
      "enum": [
        "run",
        "workflow",
        "job",
        "attempt"
      ],
      "type": "string",
      "description": "What target_id identifies."
    }
  }
}

depot_ci_get_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.

read-only

Argument	Type	Description
job_id*	string	CI job id, from depot_ci_get_run_status.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "minLength": 1,
      "description": "CI job id, from depot_ci_get_run_status."
    }
  }
}

depot_ci_get_job_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.

read-only

Argument	Type	Description
job_id	string	CI job id — resolves to its latest attempt.
attempt_id	string	A specific attempt id.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "CI job id — resolves to its latest attempt."
    },
    "attempt_id": {
      "type": "string",
      "description": "A specific attempt id."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    }
  }
}

depot_ci_get_run_status

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.

read-only

Argument	Type	Description
run_id*	string	CI run id, from depot_ci_list_runs.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "minLength": 1,
      "description": "CI run id, from depot_ci_list_runs."
    }
  }
}

depot_ci_list_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.

read-only

Argument	Type	Description
pr	string	Pull request number. Requires repo.
sha	string	Commit SHA prefix (1-40 hex chars).
repo	string	Repository in owner/name format, e.g. depot/cli.
status	array	Run statuses to include (ORed). Default on Depot's side: running and queued.
trigger	string	Trigger event, e.g. push, pull_request, schedule, workflow_dispatch.
page_size	integer	Page size, 1-100.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pr": {
      "type": "string",
      "description": "Pull request number. Requires repo."
    },
    "sha": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{1,40}$",
      "description": "Commit SHA prefix (1-40 hex chars)."
    },
    "repo": {
      "type": "string",
      "description": "Repository in owner/name format, e.g. depot/cli."
    },
    "status": {
      "type": "array",
      "items": {
        "enum": [
          "queued",
          "running",
          "finished",
          "failed",
          "cancelled"
        ],
        "type": "string"
      },
      "description": "Run statuses to include (ORed). Default on Depot's side: running and queued."
    },
    "trigger": {
      "type": "string",
      "description": "Trigger event, e.g. push, pull_request, schedule, workflow_dispatch."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    }
  }
}

depot_ci_list_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.

read-only

Argument	Type	Description
pr	string	Pull request number.
sha	string	Commit SHA prefix (1-40 hex chars).
name	string	Text to match in the workflow name or file path.
repo	string	Repository in owner/name format.
status	array	Workflow statuses to include (ORed).
trigger	string	Trigger event, e.g. push or pull_request.
page_size	integer	Page size, 1-200.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pr": {
      "type": "string",
      "description": "Pull request number."
    },
    "sha": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{1,40}$",
      "description": "Commit SHA prefix (1-40 hex chars)."
    },
    "name": {
      "type": "string",
      "description": "Text to match in the workflow name or file path."
    },
    "repo": {
      "type": "string",
      "description": "Repository in owner/name format."
    },
    "status": {
      "type": "array",
      "items": {
        "enum": [
          "queued",
          "running",
          "finished",
          "failed",
          "cancelled"
        ],
        "type": "string"
      },
      "description": "Workflow statuses to include (ORed)."
    },
    "trigger": {
      "type": "string",
      "description": "Trigger event, e.g. push or pull_request."
    },
    "page_size": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Page size, 1-200."
    }
  }
}

depot_ci_retry_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.

destructive

Argument	Type	Description
workflow_id*	string	Workflow id, from depot_ci_get_run_status or depot_ci_list_workflows.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "workflow_id"
  ],
  "properties": {
    "workflow_id": {
      "type": "string",
      "minLength": 1,
      "description": "Workflow id, from depot_ci_get_run_status or depot_ci_list_workflows."
    }
  }
}

depot_ci_retry_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.

destructive

Argument	Type	Description
job_id*	string	Job id to retry.
workflow_id*	string	Workflow id containing the job, from depot_ci_get_run_status.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "workflow_id",
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "minLength": 1,
      "description": "Job id to retry."
    },
    "workflow_id": {
      "type": "string",
      "minLength": 1,
      "description": "Workflow id containing the job, from depot_ci_get_run_status."
    }
  }
}

depot_create_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.

destructive

Argument	Type	Description
name*	string	Display name for the project.
hardware	string	Builder size, e.g. HARDWARE_16X32 (16 CPU / 32 GB).
region_id*	string	Depot region or cloud connection, e.g. us-east-1 or eu-central-1.
cache_keep_gb	integer	Max cache size per architecture, GB (25-1000). Default 50.
cache_keep_days	integer	Days to keep cache entries since last use (1-30). Default 14.
organization_id	string	Owning organization. Only needed for user tokens that belong to more than one org.
build_timeout_minutes	integer	Max duration of each build, minutes. Omit for no timeout.
max_concurrent_builds

depot_get_build

Get one container build's status, timestamps, duration, time saved and cached/total step counts. Depot: core BuildService/GetBuild.

read-only

Argument	Type	Description
build_id*	string	Build id, from depot_list_builds.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "build_id"
  ],
  "properties": {
    "build_id": {
      "type": "string",
      "minLength": 1,
      "description": "Build id, from depot_list_builds."
    }
  }
}

depot_get_build_step_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.

read-only

Argument	Type	Description
build_id*	string	Build id.
page_size	integer	Page size, 1-1000.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.
project_id*	string	Project id the build belongs to.
step_digest*	string	The step's digest, from depot_get_build_steps.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_id",
    "build_id",
    "step_digest"
  ],
  "properties": {
    "build_id": {
      "type": "string",
      "minLength": 1,
      "description": "Build id."
    },
    "page_size": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Page size, 1-1000."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "Project id the build belongs to."
    },
    "step_digest": {
      "type": "string",
      "minLength": 1,
      "description": "The step's digest, from depot_get_build_steps."
    }
  }
}

depot_get_build_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.

read-only

Argument	Type	Description
build_id*	string	Build id, from depot_list_builds.
page_size	integer	Page size, 1-1000.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.
project_id*	string	Project id the build belongs to.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_id",
    "build_id"
  ],
  "properties": {
    "build_id": {
      "type": "string",
      "minLength": 1,
      "description": "Build id, from depot_list_builds."
    },
    "page_size": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Page size, 1-1000."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "Project id the build belongs to."
    }
  }
}

depot_get_project

Get one Depot project — name, region, hardware size, cache policy, build timeout and autoscaling. Depot: ProjectService/GetProject.

read-only

Argument	Type	Description
project_id*	string	Project id, from depot_list_projects.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_id"
  ],
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "Project id, from depot_list_projects."
    }
  }
}

depot_get_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.

read-only

Argument	Type	Description
end_at*	string	Window end, RFC 3339 (e.g. 2026-09-30T00:00:00Z).
start_at*	string	Window start, RFC 3339 (e.g. 2026-09-01T00:00:00Z).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "start_at",
    "end_at"
  ],
  "properties": {
    "end_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window end, RFC 3339 (e.g. 2026-09-30T00:00:00Z)."
    },
    "start_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window start, RFC 3339 (e.g. 2026-09-01T00:00:00Z)."
    }
  }
}

depot_gha_get_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.

read-only

Argument	Type	Description
jobs	array	Job display names to include.
end_at	string	Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z).
start_at	string	Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z).
workflows	array	Workflow names to include.
repositories	array	Connected repositories in owner/name format, e.g. ["acme/widgets"]. Empty = all.
runner_labels	array	Runner labels to include, e.g. depot-ubuntu-24.04-8.
workflow_paths	array	Workflow file paths to include, e.g. .github/workflows/ci.yml.
aggregation_unit	string	Bucket size. Default: day.

depot_gha_list_jobs

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.

read-only

Argument	Type	Description
query	string	Case-insensitive text matched against job and workflow names; numeric values also match exact GitHub job/run ids.
end_at	string	Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z).
start_at	string	Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z).
statuses	array	Job states to include.
page_size	integer	Page size, 1-250.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.
conclusions	array	Job conclusions to include, e.g. ["failure"].
repositories	array	Connected repositories in owner/name format, e.g. ["acme/widgets"]. Empty = all.

depot_gha_list_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.

read-only

Argument	Type	Description
jobs	array	Job display names to include.
end_at	string	Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z).
start_at	string	Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z).
page_size	integer	Page size, 1-250.
workflows	array	Workflow names to include.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.
repositories	array	Connected repositories in owner/name format, e.g. ["acme/widgets"]. Empty = all.
runner_labels	array	Runner labels to include, e.g. depot-ubuntu-24.04-8.

depot_gha_search_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.

read-only

Argument	Type	Description
query	string	Text to match in log bodies, e.g. "timeout". Empty returns unfiltered lines.
end_at	string	Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z).
actions	array	Actions to include, e.g. actions/checkout.
start_at	string	Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z).
page_size	integer	Page size, 1-1000.
workflows	array	Workflow names to include.
compute_id	string	A single Depot compute id.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.

depot_list_builds

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.

read-only

Argument	Type	Description
page_size	integer	Page size, 1-100.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.
project_id*	string	Project id, from depot_list_projects.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_id"
  ],
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "Project id, from depot_list_projects."
    }
  }
}

depot_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.

read-only

Argument	Type	Description
page_size	integer	Page size, 1-250.
region_id	string	Only projects in this region or cloud connection, e.g. us-east-1.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 250,
      "minimum": 1,
      "description": "Page size, 1-250."
    },
    "region_id": {
      "type": "string",
      "description": "Only projects in this region or cloud connection, e.g. us-east-1."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    }
  }
}

depot_list_registry_images

List the images stored in a project's Depot Registry: tag, digest, pushedAt and sizeBytes. Depot: build.v1 RegistryService/ListImages.

read-only

Argument	Type	Description
page_size	integer	Page size, 1-100.
page_token	string	Cursor from the previous response's nextPageToken. Omit for the first page.
project_id*	string	Project id, from depot_list_projects.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_id"
  ],
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "Project id, from depot_list_projects."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "jobs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Job display names to include."
    },
    "end_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z)."
    },
    "start_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z)."
    },
    "workflows": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Workflow names to include."
    },
    "repositories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Connected repositories in owner/name format, e.g. [\"acme/widgets\"]. Empty = all."
    },
    "runner_labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Runner labels to include, e.g. depot-ubuntu-24.04-8."
    },
    "workflow_paths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Workflow file paths to include, e.g. .github/workflows/ci.yml."
    },
    "aggregation_unit": {
      "enum": [
        "hour",
        "day"
      ],
      "type": "string",
      "description": "Bucket size. Default: day."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "description": "Case-insensitive text matched against job and workflow names; numeric values also match exact GitHub job/run ids."
    },
    "end_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z)."
    },
    "start_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z)."
    },
    "statuses": {
      "type": "array",
      "items": {
        "enum": [
          "queued",
          "waiting",
          "running",
          "finished"
        ],
        "type": "string"
      },
      "description": "Job states to include."
    },
    "page_size": {
      "type": "integer",
      "maximum": 250,
      "minimum": 1,
      "description": "Page size, 1-250."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    },
    "conclusions": {
      "type": "array",
      "items": {
        "enum": [
          "success",
          "failure",
          "cancelled",
          "skipped",
          "neutral"
        ],
        "type": "string"
      },
      "description": "Job conclusions to include, e.g. [\"failure\"]."
    },
    "repositories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Connected repositories in owner/name format, e.g. [\"acme/widgets\"]. Empty = all."
    },
    "runner_labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Runner labels to include."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "jobs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Job display names to include."
    },
    "end_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z)."
    },
    "start_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 250,
      "minimum": 1,
      "description": "Page size, 1-250."
    },
    "workflows": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Workflow names to include."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    },
    "repositories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Connected repositories in owner/name format, e.g. [\"acme/widgets\"]. Empty = all."
    },
    "runner_labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Runner labels to include, e.g. depot-ubuntu-24.04-8."
    },
    "workflow_paths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Workflow file paths to include, e.g. .github/workflows/ci.yml."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "description": "Text to match in log bodies, e.g. \"timeout\". Empty returns unfiltered lines."
    },
    "end_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z)."
    },
    "actions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Actions to include, e.g. actions/checkout."
    },
    "start_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Page size, 1-1000."
    },
    "workflows": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Workflow names to include."
    },
    "compute_id": {
      "type": "string",
      "description": "A single Depot compute id."
    },
    "page_token": {
      "type": "string",
      "description": "Cursor from the previous response's nextPageToken. Omit for the first page."
    },
    "repositories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Connected repositories in owner/name format, e.g. [\"acme/widgets\"]. Empty = all."
    },
    "runner_labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Runner labels to include."
    }
  }
}