Build Info

JFrog REST APIs

Content Type
REST API
ft:sourceType
Paligo

Description: Returns information about the specified build.

Since: 2.2.0

Notes: Requires JFrog Container Registry or Artifactory Pro.

Security: Requires a privileged user with deploy permissions. From version 6.6, requires read permission for the build.

Usage: GET /api/build/{buildName}/{buildNumber}

Query Parameters (optional):

Parameter

Type

Description

started

string

The timestamp of when the build started.

Supported formats: yyyy-MM-dd'T'HH:mm:ss.SSSZ or yyyy-MM-dd'T'HH:mm:ss.SSS-0000 (or yyyy-MM-dd'T'HH:mm:ss.SSS+0000)

diff

string

The number of an older build to which you want to compare contents. For more information, see Builds Diff.

project

string

The project associated with the build. If a project is not specified, or if you are not working with projects, the default build-info repository associated with your Artifactory instance is used.Projects

Produces: application/json (application/vnd.org.jfrog.build.BuildInfo+json), application/vnd.org.jfrog.build.BuildInfo+json

Sample Output:

GET /api/build/my-build/51
{
"uri": "http://localhost:8081/artifactory/api/build/my-build/51"
"buildInfo" : {
        ...
    }
}

(Optional) Run the command with the started parameter.

GET artifactory/api/build/<BUILD NAME>/<BUILD NUMBER>?started=yyyy-MM-dd'T'HH:mm:ss.SSSZ"

Example

curl -uadmin:password "http://172.16.10.35:8082/artifactory/api/build/generic-build-test/1?started=2022-02-23T12:39:45.777Z"