git.repositories.get-shadow-comparisonOne commit: every workflow and job, the source's result and ours, and the verdict
Request syntax
GET /git/api/repositories/{repoId}/shadow-comparisons/{sha}Path parameters
repoIdRequiredstring
Constraints: uuid
shaRequiredstring
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
commitOidAlwaysstring
The commit comparedrefAlwaysstring
The ref it was pushed tocommitMessageAlwaysstring, may be null
Its message; null when unknownqueuedAtAlwaysstring
When our shadow runs were queued (ISO 8601)sourceAlwaysobject
The state of the source's CI resultssource.stateAlwaysone of none, running, done
The source's results: not fetched yet, still running, or donesource.errorAlwaysstring, may be null
Why they could not be read; null when they couldsource.fetchedAtAlwaysstring, may be null
When they were last fetched (ISO 8601); null beforecomparisonAlwaysobject
Workflow by workflow, and the countscomparison.workflowsAlwaysarray of object
Every workflow, both sidescomparison.workflows[].pathAlwaysstring
The workflow file's pathcomparison.workflows[].nameAlwaysstring
The workflow namecomparison.workflows[].githubUrlAlwaysstring, may be null
A link to the source's run; null when there is nonecomparison.workflows[].jobsAlwaysarray of object
Its jobs, both sidescomparison.workflows[].jobs[].nameAlwaysstring
The job namecomparison.workflows[].jobs[].githubAlwaysobject, may be null
The source's result; null when the source did not run itcomparison.workflows[].jobs[].github.outcomeAlwaysone of success, failure, cancelled, skipped, pending
How the job endedcomparison.workflows[].jobs[].github.secondsAlwaysnumber, may be null
How long it took, in seconds; null when unknowncomparison.workflows[].jobs[].github.urlAlwaysstring, may be null
A link to it; null when nonecomparison.workflows[].jobs[].oursAlwaysobject, may be null
Our result; null when we did not run itcomparison.workflows[].jobs[].ours.outcomeAlwaysone of success, failure, cancelled, skipped, pending
How the job endedcomparison.workflows[].jobs[].ours.secondsAlwaysnumber, may be null
How long it took, in seconds; null when unknowncomparison.workflows[].jobs[].ours.noteAlwaysstring, may be null
Why it differs or did not run here; null when nothing to saycomparison.workflows[].jobs[].verdictAlwaysone of same, different, only-github, only-here, not-run-here, pending
How the two comparecomparison.summaryAlwaysobject
The comparison in countscomparison.summary.jobsAlwaysnumber
Jobs comparedcomparison.summary.sameAlwaysnumber
Jobs with the same outcome on both sidescomparison.summary.differentAlwaysnumber
Jobs with different outcomescomparison.summary.onlyGithubAlwaysnumber
Jobs only the source rancomparison.summary.onlyHereAlwaysnumber
Jobs only we rancomparison.summary.notRunHereAlwaysnumber
Jobs we did not run (shadow runs skip some)comparison.summary.pendingAlwaysnumber
Jobs not finished on one side yetcomparison.summary.durationRatioAlwaysnumber, 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 shacurl -X GET "https://console.platform-development.deutschecloud.app/git/api/repositories/repoId/shadow-comparisons/sha" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"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.