{
"opencollection": "1.0.0",
"info": {
"name": "Atlassian Admin Account Screens API",
"version": "1.0.0"
},
"request": {
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"items": [
{
"info": {
"name": "Screens",
"type": "folder"
},
"items": [
{
"info": {
"name": "Atlassian Get Screens For A Field",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/field/:fieldId/screens",
"params": [
{
"name": "fieldId",
"value": "",
"type": "path",
"description": "The ID of the field to return screens for."
},
{
"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": "expand",
"value": "",
"type": "query",
"description": "Use [expand](#expansion) to include additional information about screens in the response. This parameter accepts `tab` which returns details about the screen tabs the field is used in."
}
]
},
"docs": "Returns a [paginated](#pagination) list of the screens a field is used in.
**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
},
{
"info": {
"name": "Atlassian Add Field To Default Screen",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.atlassian.com/rest/api/3/screens/addToDefault/:fieldId",
"params": [
{
"name": "fieldId",
"value": "",
"type": "path",
"description": "The ID of the field."
}
]
},
"docs": "Adds a field to the default tab of the default screen.
**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
},
{
"info": {
"name": "Atlassian Update Screen",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.atlassian.com/rest/api/3/screens/:screenId",
"params": [
{
"name": "screenId",
"value": "",
"type": "path",
"description": "The ID of the screen."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Updates a screen. Only screens used in classic projects can be updated.
**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
},
{
"info": {
"name": "Atlassian Delete Screen",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.atlassian.com/rest/api/3/screens/:screenId",
"params": [
{
"name": "screenId",
"value": "",
"type": "path",
"description": "The ID of the screen."
}
]
},
"docs": "Deletes a screen. A screen cannot be deleted if it is used in a screen scheme, workflow, or workflow draft.
Only screens used in classic projects can be deleted."
},
{
"info": {
"name": "Atlassian Get Available Screen Fields",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/screens/:screenId/availableFields",
"params": [
{
"name": "screenId",
"value": "",
"type": "path",
"description": "The ID of the screen."
}
]
},
"docs": "Returns the fields that can be added to a tab on a screen.
**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
},
{
"info": {
"name": "Atlassian Get Screens",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/screens",
"params": [
{
"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": "id",
"value": "",
"type": "query",
"description": "The list of screen IDs. To include multiple IDs, provide an ampersand-separated list. For example, `id=10000&id=10001`."
},
{
"name": "queryString",
"value": "",
"type": "query",
"description": "String used to perform a case-insensitive partial match with screen name."
},
{
"name": "scope",
"value": "",
"type": "query",
"description": "The scope filter string. To filter by multiple scope, provide an ampersand-separated list. For example, `scope=GLOBAL&scope=PROJECT`."
},
{
"name": "orderBy",
"value": "",
"type": "query",
"description": "[Order](#ordering) the results by a field:\n\n * `id` Sorts by screen ID.\n * `name` Sorts by screen name."
}
]
},
"docs": "Returns a [paginated](#pagination) list of all screens or those specified by one or more screen IDs.
**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
},
{
"info": {
"name": "Atlassian Create Screen",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.atlassian.com/rest/api/3/screens",
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Creates a screen with a default field tab.
**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
}
]
}
],
"bundled": true
}