Hello,
The post API looks hard but I assure you it's not! The schema we show for the example has a lot of data because that is really the schema of the object that we return for an already-created pull request.
The amount of data necessary to create the pull request is very minimal. All you need is a title and a source (branch or commit).
curl -v https://api.bitbucket.org/2.0/repositories/my-username/my-repository/pullrequests \
-u my-username:my-password \
--request POST \
--header 'Content-Type: application/json' \
--data '{
"title": "My Title",
"source": {
"branch": {
"name": "staging"
}
}
}'
The pull request destination repository will be the repository from the path name, so if you're working from a fork, you'll need to add some more data.
If you're not working with a fork, branch name isn't required for destination because it will default to the mainbranch, which is usually `master`.
The author of the pull request will be the the user who's authenticated when making the API call. You cannot change the author because you can't impersonate other users.
Here is an example of a pull request where the destination is not the default mainbranch. Say my mainbranch is `master` but I want to create a pull request from `my-feature-branch` to `staging`:
curl -v https://api.bitbucket.org/2.0/repositories/my-username/my-repository/pullrequests \
-u my-username:my-password \
--request POST \
--header 'Content-Type: application/json' \
--data '{
"title": "My Title",
"description": "
"destination": {
"branch": {
"name": "staging"
}
},
"source": {
"branch": {
"name": "my-feature-branch"
}
}
}'
You can also reference a source or destination with a commit like this:
"source": {
"commit": {
"hash": "a3342b85a3fd24a40ea2ea254f40a0eadfd4ed42"
}
}If you want to add reviewers can do so like:
curl -v https://api.bitbucket.org/2.0/repositories/my-username/my-repository/pullrequests \
-u my-username:my-password \
--request POST \
--header 'Content-Type: application/json' \
--data '{
"title": "My Title",
"description": "My description.",
"source": {
"branch": {
"name": "staging"
}
},
"reviewers": [
{
"uuid": "{504c3b62-8120-4f0c-a7bc-87800b9d6f70}"
}
]
}'
Hope this helps!
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.