# Operations with Specific ProjectTeam

This resource lets you read and update the project team.
Available since YouTrack 2026.1.

|  Resource  |     ```GENERIC /api/admin/projects/{projectID}/team ```    |
| --- | --- |
|  Returned entity  |  [ProjectTeam](api-entity-ProjectTeam.html). For the description of the entity attributes, see [Supported Fields](#ProjectTeam-supported-fields) section.  |
|  Supported methods  |      * `GET`: [Read a Specific ProjectTeam](#get-ProjectTeam-method).    * `POST`: [Update a Specific ProjectTeam](#update-ProjectTeam-method).    |

## ProjectTeam attributes

User group representing all members of the project team.

Available since YouTrack 2026.1.

Extends [UserGroup](api-entity-UserGroup.html)

### 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](api-entity-Project.html)  |  The project that the team belongs to. `Read-only`.  |
|  users  |  [Array of Users](api-entity-User.html)  |  All users in the project team, including users from groups added to the team. `Read-only`.  |
|  ownUsers  |  [Array of Users](api-entity-User.html)  |  Users added to the project team directly.  |
|  groups  |  [Array of UserGroups](api-entity-UserGroup.html)  |  Groups added to the project team.  |
|  id  |  String  |  The ID of the user group. `Read-only`.  |
|  name  |  String  |  The name of the group.  |
|  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

```GENERIC
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

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

#### Sample response body

```JSON
{
  "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

```GENERIC
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

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

#### Sample request body

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

#### Sample response body

```JSON
{
  "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"
}
```