Skip to content
forgit api docs

Update the next build number

PUT
/repositories/{workspace}/{repo_slug}/pipelines_config/build_number

Update the next build number that should be assigned to a pipeline. The next build number that will be configured has to be strictly higher than the current latest build number for this repository.

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
workspace
required
string

This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example {workspace UUID}.

repo_slug
required
string

The repository.

Request Body required

Section titled “ Request Body required ”

The build number to update.

Media type application/json
object
type
required
string
next

The next number that will be used as build number.

integer
Example generated 
{
  "type": "example",
  "next": 1
}

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

The build number has been configured.

Media type application/json
object
type
required
string
next

The next number that will be used as build number.

integer
Example generated 
{
  "type": "example",
  "next": 1
}

400

Section titled “ 400 ”

The update failed because the next number was invalid (it should be higher than the current number).

Media type application/json
Error

Base type for most resource objects. It defines the common type element that identifies an object’s type. It also identifies the element as Swagger’s discriminator.

object
type
required
string
error
object
message
required
string
detail
string
data

Optional structured data that is endpoint-specific.

object
key
additional properties
any
key
additional properties
any
Example generated 
{
  "type": "example",
  "error": {
    "message": "example",
    "detail": "example",
    "data": {}
  }
}

404

Section titled “ 404 ”

The account or repository was not found.

Media type application/json
Error

Base type for most resource objects. It defines the common type element that identifies an object’s type. It also identifies the element as Swagger’s discriminator.

object
type
required
string
error
object
message
required
string
detail
string
data

Optional structured data that is endpoint-specific.

object
key
additional properties
any
key
additional properties
any
Example generated 
{
  "type": "example",
  "error": {
    "message": "example",
    "detail": "example",
    "data": {}
  }
}