---
title: "Migrate a remote git repository"
method: POST
path: "/repos/migrate"
tags: ["repository"]
---

# Migrate a remote git repository

`POST /repos/migrate`

## Request body

- MigrateRepoOptions — MigrateRepoOptions options for migrating repository's this is used to interact with api v1
  - `auth_password` string
  - `auth_token` string
  - `auth_username` string
  - `aws_access_key_id` string
  - `aws_secret_access_key` string
  - `clone_addr` string, required
  - `description` string
  - `issues` boolean
  - `labels` boolean
  - `lfs` boolean
  - `lfs_endpoint` string
  - `milestones` boolean
  - `mirror` boolean
  - `mirror_interval` string
  - `private` boolean
  - `pull_requests` boolean
  - `releases` boolean
  - `repo_name` string, required
  - `repo_owner` string — the organization's name or individual user's name who will own the migrated repository
  - `service` 'git' | 'github' | 'gitea' | 'gitlab' | 'gogs' | 'onedev' | 'gitbucket' | 'codebase' | 'codecommit'
  - `uid` integer — deprecated (only for backwards compatibility, use repo_owner instead)
  - `wiki` boolean

## Response `201`

Repository

- Repository — Repository represents a repository
  - `allow_fast_forward_only_merge` boolean
  - `allow_manual_merge` boolean
  - `allow_merge_commits` boolean
  - `allow_merge_update` boolean
  - `allow_rebase` boolean
  - `allow_rebase_explicit` boolean
  - `allow_rebase_update` boolean
  - `allow_squash_merge` boolean
  - `archived` boolean
  - `archived_at` string, date-time
  - `autodetect_manual_merge` boolean
  - `avatar_url` string
  - `branch_count` integer
  - `clone_url` string
  - `created_at` string, date-time
  - `default_allow_maintainer_edit` boolean
  - `default_branch` string
  - `default_delete_branch_after_merge` boolean
  - `default_merge_style` string
  - `default_target_branch` string
  - `default_update_style` string
  - `description` string
  - `empty` boolean
  - `external_tracker` ExternalTracker — ExternalTracker represents settings for external tracker
    - `external_tracker_format` string — External Issue Tracker URL Format. Use the placeholders {user}, {repo} and {index} for the username, repository name and issue index.
    - `external_tracker_regexp_pattern` string — External Issue Tracker issue regular expression
    - `external_tracker_style` string — External Issue Tracker Number Format, either `numeric`, `alphanumeric`, or `regexp`
    - `external_tracker_url` string — URL of external issue tracker.
  - `external_wiki` ExternalWiki — ExternalWiki represents setting for external wiki
    - `external_wiki_url` string — URL of external wiki.
  - `fork` boolean
  - `forks_count` integer
  - `full_name` string
  - `has_actions` boolean
  - `has_code` boolean
  - `has_issues` boolean
  - `has_packages` boolean
  - `has_projects` boolean
  - `has_pull_requests` boolean
  - `has_releases` boolean
  - `has_wiki` boolean
  - `html_url` string
  - `id` integer
  - `ignore_whitespace_conflicts` boolean
  - `internal` boolean
  - `internal_tracker` InternalTracker — InternalTracker represents settings for internal tracker
    - `allow_only_contributors_to_track_time` boolean — Let only contributors track time (Built-in issue tracker)
    - `enable_issue_dependencies` boolean — Enable dependencies for issues and pull requests (Built-in issue tracker)
    - `enable_time_tracker` boolean — Enable time tracking (Built-in issue tracker)
  - `language` string
  - `languages_url` string
  - `licenses` string[]
  - `link` string
  - `mirror` boolean
  - `mirror_interval` string
  - `mirror_last_sync_at` string, date-time
  - `mirror_updated` string, date-time
  - `name` string
  - `object_format_name` 'sha1' | 'sha256' — ObjectFormatName of the underlying git repository
  - `open_issues_count` integer
  - `open_pr_counter` integer
  - `original_url` string
  - `owner` User — User represents a user
    - `active` boolean — Is user active
    - `avatar_url` string — URL to the user's avatar
    - `created` string, date-time
    - `description` string — the user's description
    - `email` string, email
    - `followers_count` integer — user counts
    - `following_count` integer
    - `full_name` string — the user's full name
    - `html_url` string — URL to the user's gitea page
    - `id` integer — the user's id
    - `is_admin` boolean — Is the user an administrator
    - `language` string — User locale
    - `last_login` string, date-time
    - `location` string — the user's location
    - `login` string — login of the user, same as `username`
    - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
    - `prohibit_login` boolean — Is user login prohibited
    - `restricted` boolean — Is user restricted
    - `source_id` integer — The ID of the user's Authentication Source
    - `starred_repos_count` integer
    - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
    - `website` string — the user's website
  - `parent` Repository — recursive
  - `permissions` Permission — Permission represents a set of permissions
    - `admin` boolean
    - `pull` boolean
    - `push` boolean
  - `private` boolean
  - `projects_mode` string
  - `release_counter` integer
  - `repo_transfer` RepoTransfer — RepoTransfer represents a pending repo transfer
    - `doer` User — User represents a user
      - `active` boolean — Is user active
      - `avatar_url` string — URL to the user's avatar
      - `created` string, date-time
      - `description` string — the user's description
      - `email` string, email
      - `followers_count` integer — user counts
      - `following_count` integer
      - `full_name` string — the user's full name
      - `html_url` string — URL to the user's gitea page
      - `id` integer — the user's id
      - `is_admin` boolean — Is the user an administrator
      - `language` string — User locale
      - `last_login` string, date-time
      - `location` string — the user's location
      - `login` string — login of the user, same as `username`
      - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
      - `prohibit_login` boolean — Is user login prohibited
      - `restricted` boolean — Is user restricted
      - `source_id` integer — The ID of the user's Authentication Source
      - `starred_repos_count` integer
      - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
      - `website` string — the user's website
    - `recipient` User — User represents a user
      - `active` boolean — Is user active
      - `avatar_url` string — URL to the user's avatar
      - `created` string, date-time
      - `description` string — the user's description
      - `email` string, email
      - `followers_count` integer — user counts
      - `following_count` integer
      - `full_name` string — the user's full name
      - `html_url` string — URL to the user's gitea page
      - `id` integer — the user's id
      - `is_admin` boolean — Is the user an administrator
      - `language` string — User locale
      - `last_login` string, date-time
      - `location` string — the user's location
      - `login` string — login of the user, same as `username`
      - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
      - `prohibit_login` boolean — Is user login prohibited
      - `restricted` boolean — Is user restricted
      - `source_id` integer — The ID of the user's Authentication Source
      - `starred_repos_count` integer
      - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
      - `website` string — the user's website
    - `teams` Team[]
      - `can_create_org_repo` boolean — Whether the team can create repositories in the organization
      - `description` string — The description of the team
      - `id` integer — The unique identifier of the team
      - `includes_all_repositories` boolean — Whether the team has access to all repositories in the organization
      - `name` string — The name of the team
      - `organization` Organization — Organization represents an organization
        - `avatar_url` string — The URL of the organization's avatar
        - `description` string — The description of the organization
        - `email` string — The email address of the organization
        - `full_name` string — The full display name of the organization
        - `id` integer — The unique identifier of the organization
        - `location` string — The location of the organization
        - `name` string — The name of the organization
        - `repo_admin_change_team_access` boolean — Whether repository administrators can change team access
        - `username` string — username of the organization deprecated
        - `visibility` 'public' | 'limited' | 'private' — The visibility level of the organization (public, limited, private)
        - `website` string — The website URL of the organization
      - `permission` 'none' | 'read' | 'write' | 'admin' | 'owner'
      - `units` string[] — Deprecated: This variable should be replaced by UnitsMap and will be dropped in later versions.
      - `units_map` object
      - `visibility` 'public' | 'limited' | 'private' — Team visibility within the organization. "private" teams are only listable by members and org owners; "limited" teams are listable by any organization member; "public" teams are listable by any signed-in user.
  - `size` integer
  - `ssh_url` string
  - `stars_count` integer
  - `template` boolean
  - `topics` string[]
  - `updated_at` string, date-time
  - `url` string
  - `watchers_count` integer
  - `website` string

## Other responses

- `403` — APIForbiddenError is a forbidden error response
- `409` — The repository with the same name already exists.
- `422` — APIValidationError is error format response related to input validation

---

[API](https://skmtc.net/gitea/apis/gitea-api.md) · [All operations](https://skmtc.net/gitea/apis/gitea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitea/gitea-api/versions/350de506cefa/schema)