Operations with Specific Organization

This resource lets you work with organizations in YouTrack.

Resource	/api/admin/organizations/{organizationID}
Returned entity	Organization. For the description of the entity attributes, see Supported Fields section.
Supported methods	`GET`: Read a Specific Organization. `POST`: Update a Specific Organization. `DELETE`: Delete a Specific Organization.

Organization attributes

Represents an organization in YouTrack.

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	The list of projects that belong to the organization.

Read a Specific Organization

Get a specific organization in YouTrack.

Request syntax

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

                    https://example.youtrack.cloud/api/admin/organizations/120-1?fields=id,key,name,projects(id,name,shortName)
                

Sample response body

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

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

                    https://example.youtrack.cloud/api/admin/organizations/120-2?fields=id,key,name,projects(id,name,shortName)
                

Sample request body

                    {
                      "name": "Acme Corporation"
                    }
                

Sample response body

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

Delete a Specific Organization

Delete a specific organization in YouTrack.

Request syntax

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

https://example.youtrack.cloud/api/admin/organizations/120-2

24 March 2026