Welcome
Extending Product Functions
You can create your own plug-ins to extend the product’s capabilities.
REST API reference
The Build server has a REST interface, which you can use to automate tasks on the server.
REST commands for Build
The following list shows the commands that are available.
projects resource
Get project details
Returns the details of the project

Build
Build offers the capability to build applications, manage continuous integration workflows, and store build artifacts.
System requirements
Overview of Build
Build is a continuous integration and build-management system.
Tutorials
Administering
Users with the correct permissions can configure security, create users, configure integrations, and create notifications and announcements among other things.
Creating and Managing Projects
Projects run builds, manage dependencies with third-party tools, and can be used for administrative, operational, and system maintenance.
Build pipelines
A build pipeline defines the automated process that transforms source code into deployable artifacts. It specifies the steps required to compile, test, validate, scan, and package the code.
Creating Jobs and Processes
Jobs are the core building blocks of Build. Process definitions assemble jobs into the basic unit of automation. A process definition determines how, when, and where jobs run.
Managing Project Templates
Project templates are reusable plans that map build processes.
Monitoring and Reporting
With the monitoring tools you can review current and historical activity and save your filter conditions for future use. You can create charts and reports from most database tables.
Extending Product Functions
You can create your own plug-ins to extend the product’s capabilities.
- Plug-ins
  Build plug-ins provide tools for creating workflows and integrating with external tools.
- Example plug-in
  A plug-in consists of one or more steps. A step represents a unit of functionality that a user can configure and combine with other steps into a process. Creating a plug-in consists of defining its individual steps and then grouping them for presentation in Build.
- Build Scripting
  The scripting API describes the various types of supported scripts.
- Properties in Build
  Properties can be set for many different things, including projects, build configurations, process configurations, build requests, and the server. You can also set and retrieve agent properties.
- REST API reference
  The Build server has a REST interface, which you can use to automate tasks on the server.
  - Running REST commands
    Many different programs can run REST commands. To run the command, you call a method on a REST resource and pass parameters or a request in JSON format.
  - Authenticating for REST commands
    The way that you authenticate to run REST commands depends on how the server is set up and the tool that you are using to run the commands.
  - REST API conventions
    The Build REST API follows a set of conventions to make interacting with it more consistent.
  - REST commands for Build
    The following list shows the commands that are available.
    - agentPools resource
    - agents resource
      Resources for working with agents.
    - artifactsets resource
    - authenticationRealm resource
    - authorizationRealm resource
    - authtoken resource
    - authtokens resource
    - build-lives resource
    - buildProcessTemplates resource
      Resources for working with build process templates.
    - codestation-build-lives resource
    - codestation-projects resource
    - conf/locale resource
    - currentActivity resource
    - dashboard resource
    - dependencyConfig resource
    - dynamicAgentPools resource
    - file resource
    - files resource
    - fixedAgentPools resource
    - group resource
    - import resource
    - jobPreConditions resource
    - jobPreConditionScripts resource
    - jobs resource
    - label resource
    - logs resource
    - myactivity resource
    - notificationSubscriptions resource
    - plugins resource
    - preferences resource
    - preflight resource
    - processRequests resource
    - processTemplates resource
      Resources for working with process templates.
    - projects resource
      - Get project details
        Returns the details of the project
      - /projects/{id}/buildProcesses/{id}/buildLives GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/dependencies GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/dependencies POST
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/artifact-configs GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/dependencies-xml GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/artifactSets GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/artifactSets/{set} GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/artifactSets/{set}/artifacts GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/artifactSets/{set}/artifacts/{path} GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/artifactRepositories GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/artifactRepositories/{id} GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/artifactRepositories/{id}/artifacts GET
      - /projects/{id}/buildProcesses/{id}/buildLives/latest/artifactRepositories/{id}/artifacts/{path} GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id} GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/dependencies GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/dependencies POST
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/artifact-configs GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/dependencies-xml GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/artifactSets GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/artifactSets/{set} GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/artifactSets/{set}/artifacts GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/artifactSets/{set}/artifacts/{path} GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/artifactRepositories GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/artifactRepositories/{id} GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/artifactRepositories/{id}/artifacts GET
      - /projects/{id}/buildProcesses/{id}/buildLives/{id}/artifactRepositories/{id}/artifacts/{path} GET
      - /projects/{id}/buildProcesses/{id}/dependencies GET
      - /projects/{id}/buildProcesses/{id}/dependencies PUT
      - /projects/{id}/buildProcesses/{id}/dependencies POST
      - /projects/{id}/buildProcesses/{id}/dependencies/complex GET
      - /projects/{id}/buildProcesses/{id}/dependencies/{id} GET
      - /projects/{id}/buildProcesses/{id}/dependencies/{id} PUT
      - /projects/{id}/buildProcesses/{id}/dependencies/{id} DELETE
      - /projects/{id}/buildProcesses/{id}/triggers GET
      - /projects/{id}/buildProcesses/{id}/triggers POST
      - /projects/{id}/buildProcesses/{id}/triggers/{id} GET
      - /projects/{id}/buildProcesses/{id}/triggers/{id} PUT
      - /projects/{id}/buildProcesses/{id}/triggers/{id} DELETE
      - /projects/{id}/buildProcesses/{id}/successRateReport GET
      - /projects/{id}/buildProcesses/{id}/successRateReport PUT
      - /projects/{id}/secondaryProcesses/{id}/dashboardActivity GET
      - /projects/{id}/secondaryProcesses/{id}/triggers GET
      - /projects/{id}/secondaryProcesses/{id}/triggers POST
      - /projects/{id}/secondaryProcesses/{id}/triggers/{id} GET
      - /projects/{id}/secondaryProcesses/{id}/triggers/{id} PUT
      - /projects/{id}/secondaryProcesses/{id}/triggers/{id} DELETE
      - /projects/{id}/notificationSubscriptions GET
      - /projects/{id}/recentProcessActivity GET
      - /projects/{id}/latestStatus GET
      - /projects/{id}/latestBuilds GET
      - /projects/{id}/sourceChanges GET
      - /projects/{id}/sourceChangesByUser GET
      - Create a build process
      - Create a label.
      - Create a label.
      - Create a project
      - Create a secondary process
      - Create a source config
      - Create a status.
      - Create a status.
      - Delete a specified name property in process propertes
      - Delete a specified name property in process propertes
      - Delete a specified name property in process propertes
      - Delete the build process
      - Delete the project
      - Delete the secondary process
      - Delete the source config
      - Get a summary of all the findings in the source analytic report
        Return a JSON representation of the summary of all the findings in the source analytic report.
      - Get a summary of all the findings in the source analytic report
        Return a JSON representation of the summary of all the findings in the source analytic report.
      - Get activities shown on the process dashboard
        Return a JSON representation of the activities on the process dashboard
      - Get all the source analytic reports
        Return a JSON representation of all source analytic reports.
      - Get all the source analytic reports
        Return a JSON representation of all source analytic reports.
      - Get all the source analytic summary reports
        Return a JSON representation of all source analytic summary reports.
      - Get all the source analytic summary reports
        Return a JSON representation of all source analytic summary reports.
      - Get dependencies of the build process
        Return a XML representation of the dependencies of the build process
      - Get dependency summaries of the build process
        Return a JSON representation of the dependency summaries of the build process
      - Get general dependency configuration of the build process
      - Get information about all code coverage reports
        Return a JSON representation of all code coverage reports.
      - Get information about all code coverage reports
        Return a JSON representation of all code coverage reports.
      - Get information about all issues.
        Return a JSON representation of all issues.
      - Get information about all issues.
        Return a JSON representation of all issues.
      - Get information about all labels
        Return a JSON Array representation of all labels.
      - Get information about all labels
        Return a JSON Array representation of all labels.
      - Get information about all of the findings in the source analytic report
        Return a JSON representation of all the findings in the source analytic report.
      - Get information about all of the findings in the source analytic report
        Return a JSON representation of all the findings in the source analytic report.
      - Get information about all source change sets
        Return a JSON Array representation of all source change sets.
      - Get information about all source change sets
        Return a JSON Array representation of all source change sets.
      - Get information about all source configs
        Return a JSON representation of all source configs.
      - Get information about all statuses
        Return a JSON Array representation of all statuses.
      - Get information about all statuses
        Return a JSON Array representation of all statuses.
      - Get information about all test reports
        Return a JSON representation of all test reports.
      - Get information about all test reports
        Return a JSON representation of all test reports.
      - Get information about build activity for a specific build life
        Return a JSON representation of the build activity
      - Get information about changeset for a specific userName
        Return a JSON representation of the changeset
      - Get information about changeset for a specific userName
        Return a JSON representation of the changeset
      - Get information about queried build processes
        Return a JSON representation of build processes.
      - Get information about queried processes
        Return a JSON representation of processes.
      - Get information about queried projects
        Return a JSON representation of queried projects.
      - Get information about queried secondary processes
        Return a JSON representation of secondary processes.
      - Get information about the build process
        Return a JSON representation of the build process
      - Get information about the project
        Return a JSON representation of the project
      - Get information about the secondary process
        Return a JSON representation of the secondary process
      - Get information about the source analytic report
        Return a JSON representation of the source analytic report.
      - Get information about the source analytic report
        Return a JSON representation of the source analytic report.
      - Get information about the source analytic summary report
        Return a JSON representation of the source analytic summary report.
      - Get information about the source analytic summary report
        Return a JSON representation of the source analytic summary report.
      - Get information about the source config
        Return a JSON representation of the source config
      - Get paginated build activity information
        Return a JSON representation of the activities in pages
      - Get paginated build activity information
        Return a JSON representation of the activities in pages and in a specified order
      - Get properties of the build process
        Return a JSON representation of the properties of the build process
      - Get properties on a process
      - Get properties on a process
      - Get properties on a process
      - Get status summaries of the build process
        Return a JSON representation of the status summaries of the build process
      - Update general dependency configuration of the build process
      - Update or create property on a process
      - Update or create property on a process
      - Update or create property on a process
      - Update the build process
      - Update the project
      - Update the secondary process
      - Update the source config
    - radiator resource
    - repo resource
    - reporting resource
    - reports resource
    - repositories resource
    - requestStatuses resource
    - resource resource
    - resourceRole resource
    - resourceType resource
    - role resource
    - search resource
    - secondaryProcessTemplates resource
      Resources for working with secondary process templates.
    - security resource
    - sourceTemplates resource
      Resources for working with source config templates.
    - stage resource
    - statuses resource
    - stepPreConditionScripts resource
    - steps resource
    - system resource
    - team resource
    - templates resource
      Resources for working with project templates.
    - trends resource
    - user resource
    - users resource
    - workDirScripts resource
    - workflow/{workflowId/dependencies resource
    - workflow/massdependencytree resource
    - workflowStatuses resource

Get project details

Returns the details of the project

Request

GET https://{hostname}:{port}
  /build/rest2/projects/{id}

Table 1. URL parameters
Parameter	Type	Required	Description
id	string	true	Project id or project name