---
title: "Import repository from Bitbucket Server"
method: POST
path: "/api/v4/import/bitbucket_server"
tags: ["project_import"]
---

# Import repository from Bitbucket Server

`POST /api/v4/import/bitbucket_server`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/import/bitbucket_server`
- Auth: none declared

Imports a repository from Bitbucket Server to GitLab. The Bitbucket Project Key is only used for finding the repository in Bitbucket. You must specify a `target_namespace` if you want to import the repository to a GitLab group.

## Request body

- PostApiV4ImportBitbucketServer: Import repository from Bitbucket Server
  - `bitbucket_server_url` string, required: Bitbucket Server URL
  - `bitbucket_server_username` string, required: BitBucket Server Username
  - `personal_access_token` string, required: BitBucket Server personal access token/password
  - `bitbucket_server_project` string, required: BitBucket Server Project Key
  - `bitbucket_server_repo` string, required: BitBucket Server Repository Name
  - `new_name` string: New repo name
  - `new_namespace` string: Namespace to import repo into
  - `timeout_strategy` 'optimistic' | 'pessimistic': Strategy for behavior on timeouts

## Response `201`

Import repository from Bitbucket Server

- ProjectEntity: ProjectEntity model
  - `id` integer, required
  - `name` string, required
  - `full_path` string, required
  - `full_name` string, required
  - `refs_url` string, required
  - `forked` boolean, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable entity
- `503`: Service unavailable

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)