how to add status to commit

[Jin Wu]

hi there,

I want to use rest api 2.0 to add status to a commit by below api, but may i know how to specify {key} ?

/2.0/repositories/{workspace}/{repo_slug}/commit/{commit}/statuses/build/{key}

[Theodora Boudale]

Hi @Jin Wu,

The API endpoint you mention in your question can be used to get or update an existing build status.

If you'd like to add a new status, you'll need to use

/2.0/repositories/{workspace}/{repo_slug}/commit/{commit}/statuses/build

• https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Bworkspace%7D/%7Brepo_slug%7D/commit/%7Bcommit%7D/statuses/build

There is an example also in the above doc:

curl https://api.bitbucket.org/2.0/repositories/my-workspace/my-repo/commit/e10dae226959c2194f2b07b077c07762d93821cf/statuses/build/ -X POST -u jdoe -H 'Content-Type: application/json' -d '{
"key": "MY-BUILD",
"state": "SUCCESSFUL",
"description": "42 tests passed",
"url": "https://www.example.org/my-build-result"
}'

The key can be any value you like, but I suggest that it is unique among that commit's statuses. If the specified key already exists, the existing status object will be overwritten.

If you have any questions, please feel free to let me know.

Kind regards,
Theodora