Operations with Specific ProjectTeam

This resource lets you read and update the project team.

Resource	/api/admin/projects/{projectID}/team
Returned entity	ProjectTeam. For the description of the entity attributes, see Supported Fields section.
Supported methods	`GET`: Read a Specific ProjectTeam. `POST`: Update a Specific ProjectTeam.

ProjectTeam attributes

User group representing all members of the project team.

Extends UserGroup

Attributes

This table describes attributes of the ProjectTeam 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
project	Project	The project that the team belongs to. `Read-only`.
users	Array of Users	All users in the project team, including users from groups added to the team. `Read-only`.
ownUsers	Array of Users	Users added to the project team directly.
groups	Array of UserGroups	Groups added to the project team.
id	String	The ID of the user group. `Read-only`.
name	String	The name of the group. `Read-only`.
ringId	String	ID of the group in Hub. Use this ID for operations in Hub, and for matching groups between YouTrack and Hub. `Read-only`. `Can be null`.
usersCount	Long	The number of users in the group. `Read-only`.
icon	String	The URL of the group logo. `Read-only`. `Can be null`.
allUsersGroup	Boolean	True if this group contains all users, otherwise false. `Read-only`.

Read a Specific ProjectTeam

Read the project team.

Required permissions

Requires permissions: Read Project Basic.

Request syntax

GET /api/admin/projects/{projectID}/team?{fields}

null	The database ID of ProjectTeam

Request parameters

Parameter	Type	Description
fields	String	A list of ProjectTeam attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.

Sample

Sample request

                    https://example.youtrack.cloud/api/admin/projects/0-6/team?fields=id,users(id,login),ownUsers(id,login),groups(id,name)
                

Sample response body

                    {
                      "id": "23-7",
                      "users": [
                        {
                          "login": "jane.doe",
                          "id": "1-2"
                        },
                        {
                          "login": "john.smith",
                          "id": "1-3"
                        }
                      ],
                      "ownUsers": [
                        {
                          "login": "jane.doe",
                          "id": "1-2"
                        }
                      ],
                      "groups": [
                        {
                          "name": "Developers",
                          "id": "23-1"
                        }
                      ],
                      "$type": "ProjectTeam"
                    }
                

Update a Specific ProjectTeam

Update the users and groups that are added to the project team directly.

Required permissions

Requires permissions: Update Project.

Request syntax

POST /api/admin/projects/{projectID}/team?{fields}

null	The database ID of ProjectTeam

Request parameters

Parameter	Type	Description
fields	String	A list of ProjectTeam attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.

Sample

Sample request

                    https://example.youtrack.cloud/api/admin/projects/0-6/team?fields=id,users(id,login),ownUsers(id,login),groups(id,name)
                

Sample request body

                    {
                      "ownUsers": [
                        {
                          "id": "1-2"
                        }
                      ],
                      "groups": [
                        {
                          "id": "23-1",
                          "$type": "NestedGroup"
                        }
                      ]
                    }
                

Sample response body

                    {
                      "id": "23-7",
                      "users": [
                        {
                          "login": "jane.doe",
                          "id": "1-2"
                        },
                        {
                          "login": "john.smith",
                          "id": "1-3"
                        }
                      ],
                      "ownUsers": [
                        {
                          "login": "jane.doe",
                          "id": "1-2"
                        }
                      ],
                      "groups": [
                        {
                          "name": "Developers",
                          "id": "23-1"
                        }
                      ],
                      "$type": "ProjectTeam"
                    }
                

20 May 2026