TeamCity REST API Reference
 
2023.05
You are viewing the documentation for an earlier version of TeamCity REST API Reference.
  1. Autogenerated REST API Reference
  2. Locators
  3. ChangeLocator

ChangeLocator

Last modified: 22 May 2023

Represents a locator string for filtering Change entities. Examples:

  • username:MyVCSUsername — find last 100 changes made by user with MyVCSUsername VCS username.

  • pending:true,buildType:<buildTypeLocator> — find all pending changes on build configuration found by buildTypeLocator.

Properties

Dimension

Data type

Format

Description

affectedProject

string

ProjectLocator

Project (direct or indirect parent) locator.

build

string

BuildLocator

Build locator.

buildType

string

BuildTypeLocator

Build type locator.

comment

string

count

integer

int32

For paginated calls, how many entities to return per page.

file

string

id

string

Entity ID.

internalVersion

string

Commit SHA.

item

string

item:(<locator1>),item:(<locator2>...)

Supply multiple locators and return a union of the results.

pending

boolean

Is pending.

project

string

ProjectLocator

Project locator.

sinceChange

string

Commit SHA since which the changes should be returned.

start

integer

int32

For paginated calls, from which entity to start rendering the page.

user

string

UserLocator

User locator.

username

string

VCS side username.

vcsRoot

string

VcsRootLocator

VCS root locator.

vcsRootInstance

string

VcsRootInstanceLocator

VCS instance locator.

version

string