git.repositories.list-shadow-comparisons

A shadowed mirror's newest commits: the source's CI and ours side by side, in counts

GET /git/api/repositories/{repoId}/shadow-comparisonsIAM ci:ListRunsRead

Request syntax

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

Path parameters

  • repoIdRequired

    string

    Constraints: uuid

Response

200 with up to 100 shadowed commits, newest first: commitOid, ref, commitMessage, queuedAt, `source` (the state of the source's results) and `summary` (jobs, same, different, onlyGithub, onlyHere, notRunHere, pending, durationRatio).

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
  • [].​summaryAlways

    object

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

    number

    Jobs compared
  • [].​summary.​sameAlways

    number

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

    number

    Jobs with different outcomes
  • [].​summary.​onlyGithubAlways

    number

    Jobs only the source ran
  • [].​summary.​onlyHereAlways

    number

    Jobs only we ran
  • [].​summary.​notRunHereAlways

    number

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

    number

    Jobs not finished on one side yet
  • [].​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 list-shadow-comparisons repoId

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