---
title: "POST /vcs/bitbucket/docs-project/{uid}/pull-request"
method: POST
path: "/vcs/bitbucket/docs-project/{uid}/pull-request"
tags: ["vcs"]
---

# POST /vcs/bitbucket/docs-project/{uid}/pull-request

`POST /vcs/bitbucket/docs-project/{uid}/pull-request`

## Request

- Base URL: `https://api.scalar.com/core`
- URL: `https://api.scalar.com/core/vcs/bitbucket/docs-project/{uid}/pull-request`
- Auth: HTTP bearer

Create a pull request on the Bitbucket repo backing a `provider: 'bitbucket'` DocsProject, or update the open one from the same branch.

## Path parameters

- `uid` string, required

## Request body

- object
  - `head` string, required
  - `base` string, required
  - `title` string, required
  - `body` string
  - `draft` boolean, required

## Response `200`

Default Response

- object
  - `url` string, required
  - `number` number, required
  - `alreadyExists` boolean, required

## Other responses

- `400`: Bad request
- `401`: No auth
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid payload
- `500`: Uncaught error

## Changes

- **2026-10-15** `bc14f8365ca4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scalar/apis/core/changes/vcs/bitbucket/docs-project/:uid/pull-request/post.md)

---

[API](https://skmtc.dev/scalar/apis/core.md) - [All operations](https://skmtc.dev/scalar/apis/core/llms.txt) - [OpenAPI document](https://skmtc.dev/scalar/apis/core/revisions/b3aa8493faa8?raw)