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

# Import repository from Bitbucket Cloud

`POST /api/v4/import/bitbucket`

## Request

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

Imports a repository from Bitbucket Cloud to GitLab. Prerequisites: - The prerequisites for Bitbucket Cloud importer. This feature was introduced in GitLab 17.0.

## Request body

- PostApiV4ImportBitbucket: Import repository from Bitbucket Cloud
  - `bitbucket_email` string, required: BitBucket email
  - `bitbucket_api_token` string, required: BitBucket API token
  - `repo_path` string, required: Repository path
  - `target_namespace` string, required: Target namespace
  - `new_name` string: New repository name

## Response `201`

Import repository from Bitbucket Cloud

- ProjectImportEntity: ProjectImportEntity model
  - `id` integer, required
  - `name` string, required
  - `full_path` string, required
  - `full_name` string, required
  - `refs_url` string, required
  - `forked` boolean, required
  - `import_source` string, required
  - `import_status` 'scheduled' | 'started' | 'finished' | 'failed' | 'canceled', required
  - `human_import_status_name` string, required
  - `provider_link` string, required
  - `import_error` string
  - `import_warning` string
  - `relation_type` string, 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)