git.repositories.update-mirrorChange a mirror's interval, the minute poll, or shadow CI
Request syntax
PATCH /git/api/repositories/{repoId}/mirror
{
"intervalMinutes": "number",
"continuous": "boolean",
"shadowCi": "object"
}Path parameters
repoIdRequiredstring
Constraints: uuid
Request body
intervalMinutesOptionalnumber
Minutes between full fetches
Constraints: integer, 5-1440
continuousOptionalboolean
Check the source every minute (git ls-remote) and fetch when a ref moved
shadowCiOptionalobject
Run the source workflows here on mirrored pushes to compare: no secrets, no deploy or publish jobs
Constraints: JSON
Response
200 with the mirror's settings after the change: provider, sourceUrl, intervalMinutes, continuous, shadowCi, lastSyncedAt, lastError and hasToken.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
providerAlwaysone of github, gitlab, git
Where it comes from: GitHub, GitLab, or any git URLsourceUrlAlwaysstring
The source followed, without credentialsintervalMinutesAlwaysnumber
Minutes between full fetcheslastSyncedAtAlwaysstring, may be null
When the last sync finished (ISO 8601); null before the firstlastErrorAlwaysstring, may be null
Why the last sync failed; null when it did notpullsUpdatedThroughWhen presentstring
Pull requests changed on the source up to this time (ISO 8601) are inpullsUpdatedAtCorrectedAtWhen presentstring
When the imported pull requests' update times were taken from the sourcemergeMethodsReadAtWhen presentstring
When the source's merge methods were last applied here (ISO 8601)continuousWhen presentboolean
The source is checked every minute and fetched as soon as a ref movedshadowCiWhen presentobject
Running the source's workflows here to compare; absent when never setshadowCi.enabledAlwaysboolean
Shadow CI runs on mirrored pushesshadowCi.branchesAlwaysarray of string
Branch patterns it runs for; the default branch when emptyhasTokenAlwaysboolean
A token for the source is kept (it is never shown)
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 git:UpdateRepository 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 update-mirror repoIdcurl -X PATCH "https://console.platform-development.deutschecloud.app/git/api/repositories/repoId/mirror" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY" \
-H "Content-Type: application/json" \
-d '{}'Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_git_repositories_update-mirror.