TeamCity REST API Reference 2025.11 Help

VcsCheckStatus

Stores information on the last known remote repository check for new changes.

Related Help article: VCS Root

Properties

status

The status of the changes check.

  • finished — the check for changes is complete, no new check is scheduled.

  • scheduled — the new check for changes is scheduled.

  • started — a check for changes is currently in progress.

requestorType

The authority that issued a check for changes request.

  • schedule — a check for changes is initiated by the TeamCity server, as a part of default repository polling mechanism.

  • build — a default check for changes that preceds any new build starting.

  • user — a TeamCity user clicked the configuration's 'Check for pending changes' action in TeamCity UI.

  • commit_hook — a check for changes was triggered by a post-commit webhook.

timestamp

The time of the latest check entry.

Schema

Below, you can find a full schema of this object, in XML and JSON formats. You can choose what fields to submit depending on your current needs. Different methods might expect different fields: the best approach is to request this entity via GET and use the response as a base for the following POST request.

A link to another object implies that you can substitute it with the schema of the linked object, if it is required for your call.

<VcsCheckStatus requestorType="schedule" status="finished" timestamp="20250414T130222+0200"/>
{ "requestorType" : "schedule", "status" : "finished", "timestamp" : "20250414T130222+0200" }
Last modified: 02 December 2025