Sign in

v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB
migrations

Update an import

An import can be updated with credentials or a project choice by passing in the appropriate parameters in this API request. If no parameters are provided, the import will be restarted.

Some servers (e.g. TFS servers) can have several projects at a single URL. In those cases the import progress will have the status detection_found_multiple and the Import Progress response will include a project_choices array. You can select the project to import by providing one of the objects in the project_choices array in the update request.

[!WARNING] Endpoint closing down notice: Due to very low levels of usage and available alternatives, this endpoint is closing down and will no longer be available from 00:00 UTC on April 12, 2024. For more details and alternatives, see the changelog.

patch/repos/{owner}/{repo}/import

Path parameters

ownerstring required

The account owner of the repository. The name is not case sensitive.

repostring required

The name of the repository without the .git extension. The name is not case sensitive.

Request body

vcs_usernamestring

The username to provide to the originating repository.

vcs_passwordstring

The password to provide to the originating repository.

vcs'subversion' | 'tfvc' | 'git' | 'mercurial'

The type of version control system you are migrating from.

tfvc_projectstring

For a tfvc import, the name of the project that is being imported.

Example request

{
  "vcs": "\"git\"",
  "tfvc_project": "\"project1\""
}

Response

Response

vcsstring nullable required
use_lfsboolean
vcs_urlstring required

The URL of the originating repository.

svc_rootstring
tfvc_projectstring
status'auth' | 'error' | 'none' | 'detecting' | 'choose' | 'auth_failed' | 'importing' | 'mapping' | 'waiting_to_push' | 'pushing' | 'complete' | 'setup' | 'unknown' | 'detection_found_multiple' | 'detection_found_nothing' | 'detection_needs_auth' required
status_textstring nullable
failed_stepstring nullable
error_messagestring nullable
import_percentinteger nullable
commit_countinteger nullable
push_percentinteger nullable
has_large_filesboolean
large_files_sizeinteger
large_files_countinteger
messagestring
authors_countinteger nullable
urlstring uri required
html_urlstring uri required
authors_urlstring uri required
repository_urlstring uri required
svn_rootstring