git.repositories.get-shadow-comparison

One commit: every workflow and job, the source's result and ours, and the verdict

GET /git/api/repositories/{repoId}/shadow-comparisons/{sha}IAM ci:ListRunsRead

Request syntax

GET /git/api/repositories/{repoId}/shadow-comparisons/{sha}

Path parameters

  • repoIdRequired

    string

    Constraints: uuid

  • shaRequired

    string

    Constraints: /^[0-9a-f]{40}$/

Response

200 with the commit (commitOid, ref, commitMessage, queuedAt, source) and `comparison`: `workflows`, each with its jobs (the source's outcome and seconds, ours, and a verdict), and the `summary` counts.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Fields of data

  • commitOidAlways

    string

    The commit compared
  • refAlways

    string

    The ref it was pushed to
  • commitMessageAlways

    string, may be null

    Its message; null when unknown
  • queuedAtAlways

    string

    When our shadow runs were queued (ISO 8601)
  • sourceAlways

    object

    The state of the source's CI results
  • source.​stateAlways

    one of none, running, done

    The source's results: not fetched yet, still running, or done
  • source.​errorAlways

    string, may be null

    Why they could not be read; null when they could
  • source.​fetchedAtAlways

    string, may be null

    When they were last fetched (ISO 8601); null before
  • comparisonAlways

    object

    Workflow by workflow, and the counts
  • comparison.​workflowsAlways

    array of object

    Every workflow, both sides
  • comparison.​workflows[].​pathAlways

    string

    The workflow file's path
  • comparison.​workflows[].​nameAlways

    string

    The workflow name
  • comparison.​workflows[].​githubUrlAlways

    string, may be null

    A link to the source's run; null when there is none
  • comparison.​workflows[].​jobsAlways

    array of object

    Its jobs, both sides
  • comparison.​workflows[].​jobs[].​nameAlways

    string

    The job name
  • comparison.​workflows[].​jobs[].​githubAlways

    object, may be null

    The source's result; null when the source did not run it
  • comparison.​workflows[].​jobs[].​github.​outcomeAlways

    one of success, failure, cancelled, skipped, pending

    How the job ended
  • comparison.​workflows[].​jobs[].​github.​secondsAlways

    number, may be null

    How long it took, in seconds; null when unknown
  • comparison.​workflows[].​jobs[].​github.​urlAlways

    string, may be null

    A link to it; null when none
  • comparison.​workflows[].​jobs[].​oursAlways

    object, may be null

    Our result; null when we did not run it
  • comparison.​workflows[].​jobs[].​ours.​outcomeAlways

    one of success, failure, cancelled, skipped, pending

    How the job ended
  • comparison.​workflows[].​jobs[].​ours.​secondsAlways

    number, may be null

    How long it took, in seconds; null when unknown
  • comparison.​workflows[].​jobs[].​ours.​noteAlways

    string, may be null

    Why it differs or did not run here; null when nothing to say
  • comparison.​workflows[].​jobs[].​verdictAlways

    one of same, different, only-github, only-here, not-run-here, pending

    How the two compare
  • comparison.​summaryAlways

    object

    The comparison in counts
  • comparison.​summary.​jobsAlways

    number

    Jobs compared
  • comparison.​summary.​sameAlways

    number

    Jobs with the same outcome on both sides
  • comparison.​summary.​differentAlways

    number

    Jobs with different outcomes
  • comparison.​summary.​onlyGithubAlways

    number

    Jobs only the source ran
  • comparison.​summary.​onlyHereAlways

    number

    Jobs only we ran
  • comparison.​summary.​notRunHereAlways

    number

    Jobs we did not run (shadow runs skip some)
  • comparison.​summary.​pendingAlways

    number

    Jobs not finished on one side yet
  • comparison.​summary.​durationRatioAlways

    number, may be null

    Median of our duration over the source's, over jobs both finished; null when none

Checked against the handlers: every route test validates their answers against this schema.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow ci:ListRuns on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud git repositories get-shadow-comparison repoId sha

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_git_repositories_get-shadow-comparison.