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.
agents resource
Resources for working with agents.
Get information about an agent
Return a JSON representation of an agent.

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.
      - Create a environment in agent environments
      - Configure all unconfigured agents
      - Create a property in agent propertes
      - Delete a specified name environment in agent environments
      - Delete a specified name property in agent propertes
      - Delete an agent
      - Get agent properties on an agent
      - Get all properties on an agent
      - Get environments on an agent
      - Get information about all agents
        Return a JSON representation of all agents.
      - Get information about an agent
        Return a JSON representation of an agent.
      - Get locked properties on an agent
      - Get system properties on an agent
      - Update an agent
      - Update environment in agent environments
      - Update property in agent propertes
    - 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
    - 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 information about an agent

Return a JSON representation of an agent.

Request

GET https://{hostname}:{port}
  /build/rest2/agents/{id}?{parameters}

Table 1. Request parameters
Parameter	Type	Required	Description
extended	boolean	false	If set to true, retrieve information about the agent's properties.

Table 2. URL parameters
Parameter	Type	Required	Description
id	string	true	The identifier to use when looking up an agent. This can be the name or ID of the agent