git.repositories.get-import

How far an import has come: phase, branches, tags and pull requests so far, started and finished, or why it failed

GET /git/api/repositories/{repoId}/importIAM git:GetRepositoryRead

Request syntax

GET /git/api/repositories/{repoId}/import

Path parameters

  • repoIdRequired

    string

    Constraints: uuid

Response

200 with status (queued, running, succeeded, failed), phase, sourceUrl, the counts of branches, tags and pull requests so far, startedAt, finishedAt and error; `data` is null for a repository that was not imported.

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

Fields of data

  • statusAlways

    one of queued, running, succeeded, failed

    Where the import stands
  • phaseAlways

    one of waiting, history, pull-requests, finishing, done, failed

    What it is doing: waiting, fetching history, pull requests, finishing
  • sourceUrlAlways

    string

    The source, without credentials
  • includesPullRequestsAlways

    boolean

    Pull requests are brought over
  • startedAtAlways

    string, may be null

    When it started (ISO 8601); null while queued
  • finishedAtAlways

    string, may be null

    When it ended (ISO 8601); null until then
  • branchesAlways

    number

    Branches here so far
  • tagsAlways

    number

    Tags here so far
  • pullRequestsAlways

    number

    Pull requests here so far
  • errorAlways

    string, may be null

    Why it failed; null unless it did

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:GetRepository 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-import 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_get-import.