llms.txt: machine-readable documentation index. Markdown version of this page is also available.

YouTrack Developer Portal Help

Hub REST API Endpoints and Entities Deprecated in YouTrack 2026.1

Starting with version 2026.1, several Hub REST API endpoints that were previously used for YouTrack data are no longer available for this purpose. Use YouTrack REST API for YouTrack projects, project teams, and organizations. For user types, see User Types.

Entity

Hub REST API endpoint or entity

Replacement YouTrack REST API endpoint or entity

Projects

<Hub_REST_API_URL>/projects

<YouTrack_REST_API_URL>/admin/projects

Project teams

<Hub_REST_API_URL>/projects/{projectID}/team and related project team endpoints

<YouTrack_REST_API_URL>/admin/projects/{projectID}/team

  • <YouTrack_REST_API_URL>/admin/projects/{projectID}/team/users

  • <YouTrack_REST_API_URL>/admin/projects/{projectID}/team/ownUsers

  • <YouTrack_REST_API_URL>/admin/projects/{projectID}/team/groups

Organizations

<Hub_REST_API_URL>/org and related organization endpoints

<YouTrack_REST_API_URL>/admin/organizations

<YouTrack_REST_API_URL>/admin/organizations/{id}

User types

UserType entity in Hub REST API

UserType entity in YouTrack REST API

Available starting with YouTrack 2026.2.

Entity IDs

Use the id returned by the YouTrack REST API for subsequent YouTrack requests. Projects and organizations do not expose ringId. Users and groups retain this attribute for correlation with Hub when available.

Projects

Starting with YouTrack 2026.1, <Hub_REST_API_URL>/projects returns Hub data, and does not return YouTrack projects. If your integration used this Hub endpoint to enumerate projects, migrate it to <YouTrack_REST_API_URL>/admin/projects.

Request fields such as id, name, and shortName to get the project identifiers that most integrations use.

Project Teams

Hub REST API endpoints for project teams are no longer available for YouTrack project teams starting with YouTrack 2026.1. Use the project team subresource in YouTrack REST API instead.

The /team/users subresource returns all users in the project team, including users who are included through groups. Add direct team members with POST <YouTrack_REST_API_URL>/admin/projects/{projectID}/team/ownUsers. To add user groups to a project team, use <YouTrack_REST_API_URL>/admin/projects/{projectID}/team/groups.

Organizations

Hub REST API endpoints for organizations are no longer available for YouTrack organization data starting with YouTrack 2026.1. Use <YouTrack_REST_API_URL>/admin/organizations and related YouTrack REST API endpoints instead.

User Types

For YouTrack user types, use the UserType entity in the YouTrack REST API. This entity and the userType attribute of a YouTrack user are available starting with YouTrack 2026.2.

For YouTrack users, request the userType attribute from YouTrack REST API user endpoints instead of relying on the deprecated Hub entity.

04 November 2026