ChangeLocator

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`	`ValueConditionDimensions`
`count`	`long`	`int64`	For paginated calls, how many entities to return per page.
`file`	`string`	`FileDimensions`
`id`	`long`	`int64`	Change id.
`internalVersion`	`string`	`String value`	Commit SHA.
`pending`	`string`		Is pending. Supported values: `true` `false` `any`
`project`	`string`	`ProjectLocator`	Project locator.
`sinceChange`	`string`	`ChangeLocator`	First change that should be returned.
`start`	`long`	`int64`	For paginated calls, from which entity to start rendering the page.
`user`	`string`	`UserLocator`	User locator.
`username`	`string`	`String value`	VCS side username.
`vcsRoot`	`string`	`VcsRootLocator`	VCS root locator.
`vcsRootInstance`	`string`	`VcsRootInstanceLocator`	VCS instance locator.
`version`	`string`	`ValueConditionDimensions`

Last modified: 18 August 2026