Operations with Specific Agile
This resource lets you work with agile boards in YouTrack using the REST API.
Resource | /api/agiles/{agileID} |
Returned entity | Agile. For the description of the entity attributes, see Supported Fields section. |
Supported methods |
|
Agile attributes
Represents an agile board configuration.
Related Resources
Below you can find the list of resources that let you work with this entity.
Attributes
This table describes attributes of the Agile
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 ID of the agile board. |
name | String | The name of the agile board. |
owner | User | The owner of the agile board. |
visibleFor | UserGroup | Deprecated. Use the The group of users that can view this board. Can be null . |
visibleForProjectBased | Boolean | Deprecated. When |
updateableBy | UserGroup | Deprecated. Use the The group of users who can update the settings of this board. Can be null . |
updateableByProjectBased | Boolean | Deprecated. When |
readSharingSettings | AgileSharingSettings | Users and groups that can view this board. If the board is visible only to its owner, this property contains an empty array. |
updateSharingSettings | AgileSharingSettings | Users and groups that can update this watch folder. If only the folder's owner can update it, this property contains an empty array. |
orphansAtTheTop | Boolean | When |
hideOrphansSwimlane | Boolean | When |
estimationField | CustomField | A custom field that is used as the estimation field for the board. |
originalEstimationField | CustomField | A custom field that is used as the original estimation field for the board. |
projects | Array of Projects | A collection of projects associated with the board. |
sprints | Array of Sprints | The set of sprints that are associated with the board. |
currentSprint | Sprint | A sprint that is designated as the current one for this agile board. |
columnSettings | ColumnSettings | Column settings of the board. |
swimlaneSettings | SwimlaneSettings | Settings of the board swimlanes. |
sprintsSettings | SprintsSettings | Settings of the board sprints. |
colorCoding | ColorCoding | Color coding settings for the board. |
status | AgileStatus | Status of the board. |
Read a Specific Agile
Get settings of the specific agile board.
Required permissions
The user must have permissions to read the board.
Request syntax
{agileID} | The database ID of the agile board. |
Request parameters
Parameter | Type | Description |
---|---|---|
fields | String | A list of Agile attributes that should be returned in the response. If no field is specified, only the |
Sample
Sample request
Sample response body
Update a Specific Agile
Update settings of the specific agile board.
Required permissions
The user must have permissions to update the board.
Request syntax
{agileID} | The database ID of the agile board. |
Request parameters
Parameter | Type | Description |
---|---|---|
fields | String | A list of Agile attributes that should be returned in the response. If no field is specified, only the |
Sample
Let's set WIP limit for "In Progress" and "Fixed" columns of a board.
Sample request
Sample request body
Sample response body
Delete a Specific Agile
Delete an agile board with the specific ID.
Request syntax
{agileID} | The database ID of the agile board. |
Request parameters
Parameter | Type | Description |
---|---|---|
fields | String | A list of Agile attributes that should be returned in the response. If no field is specified, only the |