{
"opencollection": "1.0.0",
"info": {
"name": "Atlassian Admin Account Project Components API",
"version": "1.0.0"
},
"request": {
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"items": [
{
"info": {
"name": "Project Components",
"type": "folder"
},
"items": [
{
"info": {
"name": "Atlassian Get Component",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/component/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the component."
}
]
},
"docs": "Returns a component.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for project containing the component."
},
{
"info": {
"name": "Atlassian Update Component",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.atlassian.com/rest/api/3/component/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the component."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Updates a component. Any fields included in the request are overwritten. If `leadAccountId` is an empty string (\"\") the component lead is removed.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** *Administer projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the component or *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
},
{
"info": {
"name": "Atlassian Delete Component",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.atlassian.com/rest/api/3/component/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the component."
},
{
"name": "moveIssuesTo",
"value": "",
"type": "query",
"description": "The ID of the component to replace the deleted component. If this value is null no replacement is made."
}
]
},
"docs": "Deletes a component.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** *Administer projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the component or *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
},
{
"info": {
"name": "Atlassian Get Component Issues Count",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/component/:id/relatedIssueCounts",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the component."
}
]
},
"docs": "Returns the counts of issues assigned to the component.
This operation can be accessed anonymously.
**Deprecation notice:** The required OAuth 2.0 scopes will be updated on June 15, 2024.
* **Classic**: `read:jira-work`
* **Granular**: `read:field:jira`, `read:project.component:jira`
**[Permissions](#permissions) required:** None."
},
{
"info": {
"name": "Atlassian Get Project Components Paginated",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/project/:projectIdOrKey/component",
"params": [
{
"name": "projectIdOrKey",
"value": "",
"type": "path",
"description": "The project ID or project key (case sensitive)."
},
{
"name": "startAt",
"value": "",
"type": "query",
"description": "The index of the first item to return in a page of results (page offset)."
},
{
"name": "maxResults",
"value": "",
"type": "query",
"description": "The maximum number of items to return per page."
},
{
"name": "orderBy",
"value": "",
"type": "query",
"description": "[Order](#ordering) the results by a field:\n\n * `description` Sorts by the component description.\n * `issueCount` Sorts by the count of issues associated with the component.\n * `lead` Sorts by the user key of the component's project lead.\n * `name` Sorts by component name."
},
{
"name": "componentSource",
"value": "",
"type": "query",
"description": "The source of the components to return. Can be `jira` (default), `compass` or `auto`. When `auto` is specified, the API will return connected Compass components if the project is opted into Compass, otherwise it will return Jira components. Defaults to `jira`."
},
{
"name": "query",
"value": "",
"type": "query",
"description": "Filter the results using a literal string. Components with a matching `name` or `description` are returned (case insensitive)."
}
]
},
"docs": "Returns a [paginated](#pagination) list of all components in a project. See the [Get project components](#api-rest-api-3-project-projectIdOrKey-components-get) resource if you want to get a full list of versions without pagination.
If your project uses Compass components, this API will return a list of Compass components that are linked to issues in that project.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** *Browse Projects* [project "
},
{
"info": {
"name": "Atlassian Get Project Components",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/project/:projectIdOrKey/components",
"params": [
{
"name": "projectIdOrKey",
"value": "",
"type": "path",
"description": "The project ID or project key (case sensitive)."
},
{
"name": "componentSource",
"value": "",
"type": "query",
"description": "The source of the components to return. Can be `jira` (default), `compass` or `auto`. When `auto` is specified, the API will return connected Compass components if the project is opted into Compass, otherwise it will return Jira components. Defaults to `jira`."
}
]
},
"docs": "Returns all components in a project. See the [Get project components paginated](#api-rest-api-3-project-projectIdOrKey-component-get) resource if you want to get a full list of components with pagination.
If your project uses Compass components, this API will return a paginated list of Compass components that are linked to issues in that project.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** *Browse Projects* [project permission](https"
},
{
"info": {
"name": "Atlassian Find Components For Projects",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/component",
"params": [
{
"name": "projectIdsOrKeys",
"value": "",
"type": "query",
"description": "The project IDs and/or project keys (case sensitive)."
},
{
"name": "startAt",
"value": "",
"type": "query",
"description": "The index of the first item to return in a page of results (page offset)."
},
{
"name": "maxResults",
"value": "",
"type": "query",
"description": "The maximum number of items to return per page."
},
{
"name": "orderBy",
"value": "",
"type": "query",
"description": "[Order](#ordering) the results by a field:\n\n * `description` Sorts by the component description.\n * `name` Sorts by component name."
},
{
"name": "query",
"value": "",
"type": "query",
"description": "Filter the results using a literal string. Components with a matching `name` or `description` are returned (case insensitive)."
}
]
},
"docs": "Returns a [paginated](#pagination) list of all components in a project, including global (Compass) components when applicable.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** *Browse Projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project."
},
{
"info": {
"name": "Atlassian Create Component",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.atlassian.com/rest/api/3/component",
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Creates a component. Use components to provide containers for issues within a project. Use components to provide containers for issues within a project.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** *Administer projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project in which the component is created or *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
}
]
}
],
"bundled": true
}