# Operations with Specific Organization

This resource lets you work with organizations in YouTrack.
Available since YouTrack 2026.1.

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

## Organization attributes

Represents an organization in YouTrack.

Available since YouTrack 2026.1.

### Attributes

This table describes attributes of the `Organization` 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 organization. `Read-only`.  |
|  key  |  String  |  The unique key of the organization.  |
|  name  |  String  |  The name of the organization.  |
|  description  |  String  |  The description of the organization. `Can be null`.  |
|  iconUrl  |  String  |  The URL of the organization's icon. `Read-only`. `Can be null`.  |
|  projects  |  [Array of Projects](api-entity-Project.html)  |  The list of projects that belong to the organization.  |

## Read a Specific Organization

Get a specific organization in YouTrack.

### Request syntax

```GENERIC
GET /api/admin/organizations/{organizationID}?{fields}
```

|  {organizationID}  |  The database ID of the organization.  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of Organization 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/organizations/120-1?fields=id,key,name,projects(id,name,shortName)
```

#### Sample response body

```JSON
{
  "id": "120-1",
  "key": "92da6595-c398-481d-9071-c821ff49772b",
  "name": "JetBrains",
  "projects": [
    {
      "id": "0-0",
      "name": "Sample Project",
      "shortName": "SP",
      "$type": "Project"
    }
  ],
  "$type": "Organization"
}
```

## Update a Specific Organization

Update a specific organization in YouTrack.

### Request syntax

```GENERIC
POST /api/admin/organizations/{organizationID}?{fields}
```

|  {organizationID}  |  The database ID of the organization.  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of Organization 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/organizations/120-2?fields=id,key,name,projects(id,name,shortName)
```

#### Sample request body

```JSON
{
  "name": "Acme Corporation"
}
```

#### Sample response body

```JSON
{
  "id": "120-2",
  "key": "acme",
  "name": "Acme Corporation",
  "projects": [],
  "$type": "Organization"
}
```

## Delete a Specific Organization

Delete a specific organization in YouTrack.

### Request syntax

```GENERIC
DELETE /api/admin/organizations/{organizationID}
```

|  {organizationID}  |  The database ID of the organization.  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of Organization 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/organizations/120-2
```