TeamCity REST API Reference 2026.2 Help

TeamCityNodeLocator

Represents a locator string for filtering Node entities. Examples:

  • id:node-1 - find a node with id node-1.

  • state:<stateLocator> - find all nodes having the given state.

  • role:<role> - finds a node with the specified role, possible values are: main_node or secondary_node.

Properties

Dimension

Data type

Format

Description

count

long

int64

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

id

string

String value

Node id.

role

string

String value

Node role (main_node or secondary_node).

start

long

int64

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

state

string

String value

Node state.

Last modified: 18 August 2026