TeamCity REST API Reference 2024.03 Help

ProjectApi

getAllProjects

Get all projects.

Endpoint

/app/rest/projects

Produces

  • application/xml

  • application/json

Parameters

  • locator: string

  • fields: string

Response

Projects

addProject

Create a new project.

Endpoint

/app/rest/projects

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

Project

deleteProject

Delete project matching the locator.

Endpoint

/app/rest/projects/{projectLocator}

Parameters

getProject

Get project matching the locator.

Endpoint

/app/rest/projects/{projectLocator}

Produces

  • application/xml

  • application/json

Parameters

Response

Project

getAgentPoolsProject

Get agent pools appointed to the matching project.

Endpoint

/app/rest/projects/{projectLocator}/agentPools

Produces

  • application/xml

  • application/json

Parameters

Response

AgentPools

addAgentPoolsProject

Assign the matching project to the agent pool.

Endpoint

/app/rest/projects/{projectLocator}/agentPools

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

AgentPool

setAgentPoolsProject

Update agent pools apppointed to the matching project.

Endpoint

/app/rest/projects/{projectLocator}/agentPools

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

AgentPools

removeProjectFromAgentPool

Unassign a project from the matching agent pool.

Endpoint

/app/rest/projects/{projectLocator}/agentPools/{agentPoolLocator}

Parameters

getAllBranches

Get all branches of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/branches

Produces

  • application/xml

  • application/json

Parameters

Response

Branches

addBuildType

Add a build configuration to the matching project.

Endpoint

/app/rest/projects/{projectLocator}/buildTypes

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

BuildType

removeDefaultTemplate

Remove the default template from the matching project.

Endpoint

/app/rest/projects/{projectLocator}/defaultTemplate

Parameters

getDefaultTemplate

Get the default template of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/defaultTemplate

Produces

  • application/xml

  • application/json

Parameters

Response

BuildType

setDefaultTemplate

Update the default template of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/defaultTemplate

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

BuildType

getAllBuildTypesOrdered

Get all build configurations from the matching project, with custom ordering applied.

Endpoint

/app/rest/projects/{projectLocator}/order/buildTypes

Produces

  • application/xml

  • application/json

Parameters

Response

BuildTypes

setBuildTypesOrder

Update custom ordering of build configurations of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/order/buildTypes

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

BuildTypes

getAllSubprojectsOrdered

Get all subprojects of the matching project, with custom ordering applied.

Endpoint

/app/rest/projects/{projectLocator}/order/projects

Produces

  • application/xml

  • application/json

Parameters

Response

Projects

setSubprojectsOrder

Update custom ordering of subprojects of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/order/projects

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

Projects

deleteBuildParameters

Delete all build parameters.

Endpoint

/app/rest/projects/{projectLocator}/parameters

Parameters

getBuildParameters

Get build parameters.

Endpoint

/app/rest/projects/{projectLocator}/parameters

Produces

  • application/xml

  • application/json

Parameters

Response

Properties

createBuildParameter

Create a build parameter.

Endpoint

/app/rest/projects/{projectLocator}/parameters

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

Property

updateBuildParameters

Update build parameters.

Endpoint

/app/rest/projects/{projectLocator}/parameters

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

Properties

deleteBuildParameter

Delete build parameter.

Endpoint

/app/rest/projects/{projectLocator}/parameters/{name}

Parameters

getBuildParameter

Get build parameter.

Endpoint

/app/rest/projects/{projectLocator}/parameters/{name}

Produces

  • application/xml

  • application/json

Parameters

Response

Property

updateBuildParameter

Update build parameter.

Endpoint

/app/rest/projects/{projectLocator}/parameters/{name}

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

Property

getBuildParameterType

Get type of build parameter.

Endpoint

/app/rest/projects/{projectLocator}/parameters/{name}/type

Produces

  • application/xml

  • application/json

Parameters

Response

Type

updateBuildParameterType

Update type of build parameter.

Endpoint

/app/rest/projects/{projectLocator}/parameters/{name}/type

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

Type

getBuildParameterSpecification

Get build parameter specification.

Endpoint

/app/rest/projects/{projectLocator}/parameters/{name}/type/rawValue

Produces

  • text/plain

Parameters

Response

string

updateBuildParameterSpecification

Update build parameter specification.

Endpoint

/app/rest/projects/{projectLocator}/parameters/{name}/type/rawValue

Consumes

  • text/plain

Produces

  • text/plain

Parameters

Response

string

getBuildParameterValue

Get value of build parameter.

Endpoint

/app/rest/projects/{projectLocator}/parameters/{name}/value

Produces

  • text/plain

Parameters

Response

string

updateBuildParameterValue

Update value of build parameter.

Endpoint

/app/rest/projects/{projectLocator}/parameters/{name}/value

Consumes

  • text/plain

Produces

  • text/plain

Parameters

Response

string

getProjectParentProject

Get the parent project of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/parentProject

Produces

  • application/xml

  • application/json

Parameters

Response

Project

setParentProject

Update the parent project of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/parentProject

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

Project

getFeatures

Get all features.

Endpoint

/app/rest/projects/{projectLocator}/projectFeatures

Produces

  • application/xml

  • application/json

Parameters

Response

object

addFeature

Add a feature.

Endpoint

/app/rest/projects/{projectLocator}/projectFeatures

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

object

updateFeatures

Update all features.

Endpoint

/app/rest/projects/{projectLocator}/projectFeatures

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

object

deleteFeature

Delete a matching feature.

Endpoint

/app/rest/projects/{projectLocator}/projectFeatures/{featureLocator}

Parameters

getFeature

Get a matching feature.

Endpoint

/app/rest/projects/{projectLocator}/projectFeatures/{featureLocator}

Produces

  • application/xml

  • application/json

Parameters

Response

object

updateFeature

Update a matching feature.

Endpoint

/app/rest/projects/{projectLocator}/projectFeatures/{featureLocator}

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

object

addSecureToken

Create a new secure token for the matching project.

Endpoint

/app/rest/projects/{projectLocator}/secure/tokens

Consumes

  • text/plain

Produces

  • text/plain

Parameters

Response

string

getSecureValue

Get a secure token of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/secure/values/{token}

Consumes

  • text/plain

Produces

  • text/plain

Parameters

Response

string

getProjectSettingsFile

Get the settings file of the matching build configuration.

Endpoint

/app/rest/projects/{projectLocator}/settingsFile

Produces

  • text/plain

Parameters

Response

string

getProjectTemplates

Get all templates of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/templates

Produces

  • application/xml

  • application/json

Parameters

Response

BuildTypes

addTemplate

Add a build configuration template to the matching project.

Endpoint

/app/rest/projects/{projectLocator}/templates

Consumes

  • application/xml

  • application/json

Produces

  • application/xml

  • application/json

Parameters

Response

BuildType

getProjectField

Get a field of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/{field}

Produces

  • text/plain

Parameters

Response

string

setProjectField

Update a field of the matching project.

Endpoint

/app/rest/projects/{projectLocator}/{field}

Consumes

  • text/plain

Produces

  • text/plain

Parameters

Response

string

Last modified: 27 March 2024