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

Used to update the current status of a build status object on the specific commit.

This operation can also be used to change other properties of the build status:

state
name
description
url
refname

The key cannot be changed.

Servers

https://api.bitbucket.org/2.0

Path parameters

Name	Type	Required	Description
`commit`	String	Yes	The commit's SHA1.
`key`	String	Yes	The build status' unique key
`repo_slug`	String	Yes	This can either be the repository slug or the UUID of the repository, surrounded by curly-braces, for example: `{repository UUID}`.
`workspace`	String	Yes	This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example: `{workspace UUID}`.

Request headers

Name	Type	Required	Description
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/json"

Request body fields

Name	Type	Required	Description
`refname`	String	No	The name of the ref that pointed to this commit at the time the status object was created. Note that this the ref may since have moved off of the commit. This optional field can be useful for build systems whose build triggers and configuration are branch-dependent (e.g. a Pipeline build). It is legitimate for this field to not be set, or even apply (e.g. a static linting job).
`name`	String	No	An identifier for the build itself, e.g. BB-DEPLOY-1
`description`	String	No	A description of the build (e.g. "Unit tests in Bamboo")
`key`	String	No	An identifier for the status that's unique to its type (current "build" is the only supported type) and the vendor, e.g. BB-DEPLOY
`url`	String	No	A URL linking back to the vendor or build system, for providing more information about whatever process produced this status. Accepts context variables `repository` and `commit` that Bitbucket will evaluate at runtime whenever at runtime. For example, one could use https://foo.com/builds/{repository.full_name} which Bitbucket will turn into https://foo.com/builds/foo/bar at render time.
`uuid`	String	No	The commit status' id.
`created_on`	String	No
`type`	String	Yes
`updated_on`	String	No
`state`	String	No	Provides some indication of the status of this commit Possible values: `"INPROGRESS"` `"STOPPED"` `"FAILED"` `"SUCCESSFUL"`
`links`	Object	No
`links.commit`	Object	No	A link to a resource related to this object.
`links.commit.href`	String	No
`links.commit.name`	String	No
`links.self`	Object	No	A link to a resource related to this object.
`links.self.href`	String	No
`links.self.name`	String	No

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.