---
schema: rendered-html/v1
title: "VcsChange | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/api-entity-VcsChange.html
generated_at: 2026-06-11T14:57:40.269273+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- YouTrack Import Scripts
- YouTrack Form API
- YouTrack REST API
- Get Started with REST API
- REST API Reference
- Entities
- AccessScope
- ActivityCategory
- ActivityCursorPage
- ActivityItem
- Agile
- AgileColumn
- AgileSharingSettings
- AgileStatus
- AppearanceSettings
- ArticleAttachment
- ArticleComment
- AssignedRole
- BackupError
- BackupFile
- BackupStatus
- BaseArticle
- BaseWorkItem
- Bundle
- BundleElement
- ChangesProcessor
- ColorCoding
- ColumnSettings
- CommandList
- CommandVisibility
- CustomField
- CustomFieldCondition
- CustomFieldDefaults
- DatabaseAttributeValue
- DatabaseBackupSettings
- DateFormatDescriptor
- DuplicateVote
- DurationValue
- EmailSettings
- Event
- ExternalArticle
- ExternalIssue
- FieldStyle
- FieldType
- FilterField
- GeneralUserProfile
- GlobalSettings
- GlobalTimeTrackingSettings
- Issue
- IssueAttachment
- IssueComment
- IssueCountResponse
- IssueCustomField
- IssueFolder
- IssueKey
- IssueLink
- IssueLinkType
- IssueTimeTracking
- IssueVoters
- IssueWatcher
- IssueWatchers
- License
- LocaleDescriptor
- LocaleSettings
- Logo
- NotificationSettings
- NotificationsUserProfile
- OnlineUsers
- Organization
- ParsedCommand
- PeriodFieldFormat
- PeriodValue
- Permission
- ProjectColor
- ProjectCustomField
- ProjectTimeTrackingSettings
- PullRequest
- PullRequestChange
- PullRequestState
- Reaction
- RestCorsSettings
- Role
- SearchSuggestions
- Sprint
- SprintsSettings
- StorageEntry
- Suggestion
- SwimlaneSettings
- SwimlaneValue
- SystemSettings
- TagSharingSettings
- Telemetry
- TextFieldValue
- TimeTrackingUserProfile
- [TimeZoneDescriptor](jetbrains__com__help__youtrack__devportal__api-entity-timezonedescriptor.md)
- [User](jetbrains__com__help__youtrack__devportal__api-entity-user.md)
- [UserGroup](jetbrains__com__help__youtrack__devportal__api-entity-usergroup.md)
- [UserProfiles](jetbrains__com__help__youtrack__devportal__api-entity-userprofiles.md)
- [UserType](jetbrains__com__help__youtrack__devportal__api-entity-usertype.md)
- [VcsChange](api-entity-VcsChange.html)
- VcsServer
- Visibility
- WIPLimit
- WatchFolderSharingSettings
- WorkItemAttribute
- WorkItemAttributePrototype
- WorkItemAttributeValue
- WorkItemProjectAttribute
- WorkItemType
- WorkTimeSettings
- Resources
- REST API Use Cases
- REST API Troubleshooting
- Color Indices List
- Hub REST API

1. YouTrack REST API
2. REST API Reference
3. Entities
4. [VcsChange](#0)

# VcsChange﻿

Last modified: 23 May 2025

Represents a VCS change linked to an issue.

## Related Resources﻿

Below you can find the list of resources that let you work with this entity.

- Issue VCS Changes

## Attributes﻿

This table describes attributes of the `VcsChange` entity.

- To receive an attribute in the response from the server, specify it explicitly in the `fields` request parameter.
- To update an attribute, provide it in the body of a POST request.

| Field | Type | Description |
| id | String | The database ID of the VCS change. `Read-only`. |
| date | DateTime | The date when the VCS change was committed to the repository. `Read-only`. |
| fetched | Long | The date when the VCS change was fetched from the repository to YouTrack. `Read-only`. `Can be null`. |
| files | Int | The number of files included into the VCS change. Equals -1 if the number of files is unknown. `Read-only`. |
| author | [User](jetbrains__com__help__youtrack__devportal__api-entity-user.md) | The author of the VCS change. `Read-only`. |
| processors | Array of ChangesProcessors | The list of version control systems that contain the VCS change. `Read-only`. |
| text | String | The commit message of the VCS change. `Read-only`. `Can be null`. |
| urls | Array of Strings | The list of links to the VCS change in the corresponding version control systems. The order is the same as in the `processors` attribute. `Read-only`. |
| version | String | The commit hash of the VCS change. `Can be null`. |
| issue | Issue | The YouTrack issue the VCS change is linked to. `Can be null`. |
| state | Byte | The code of the state of the VCS change. Here is the list of available state codes:   - 0 = default - 1 = attached manually - 2 = detached - 3 = legacy   The list of state codes may be extended in the future API versions. |

- [VcsChange](/help/youtrack/devportal/api-entity-VcsChange.html)
- [Related Resources](/help/youtrack/devportal/api-entity-VcsChange.html#yzqa54_3)
- [Attributes](/help/youtrack/devportal/api-entity-VcsChange.html#yzqa54_4)

[UserType](jetbrains__com__help__youtrack__devportal__api-entity-usertype.md)VcsServer

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.
