Skip to content

screenscheme

create-screen-scheme

Create screen scheme

Creates a screen scheme.

Permissions required: Administer Jira global permission.

POST /rest/api/3/screenscheme

FlagTypeRequiredDescription
--bodystringNorequest body (JSON string, @file, or - for stdin)

Example:

bash
jr screenscheme create-screen-scheme

delete-screen-scheme

Delete screen scheme

Deletes a screen scheme. A screen scheme cannot be deleted if it is used in an issue type screen scheme.

Only screens schemes used in classic projects can be deleted.

Permissions required: Administer Jira global permission.

DELETE /rest/api/3/screenscheme/{screenSchemeId}

FlagTypeRequiredDescription
--screenSchemeIdstringYesThe ID of the screen scheme.

Example:

bash
jr screenscheme delete-screen-scheme --screenSchemeId <screenSchemeId>

get-screen-schemes

Get screen schemes

Returns a paginated list of screen schemes.

Only screen schemes used in classic projects are returned.

Permissions required: Administer Jira global permission.

GET /rest/api/3/screenscheme

FlagTypeRequiredDescription
--expandstringNoUse expand include additional information in the response. This parameter accepts issueTypeScreenSchemes that, for each screen schemes, returns information about the issue type screen scheme the screen scheme is assigned to.
--idstringNoThe list of screen scheme IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=10000&id=10001.
--maxResultsstringNoThe maximum number of items to return per page.
--orderBystringNoOrder the results by a field:
  • id Sorts by screen scheme ID.
  • name Sorts by screen scheme name. | | --queryString | string | No | String used to perform a case-insensitive partial match with screen scheme name. | | --startAt | string | No | The index of the first item to return in a page of results (page offset). |

Example:

bash
jr screenscheme get-screen-schemes

update-screen-scheme

Update screen scheme

Updates a screen scheme. Only screen schemes used in classic projects can be updated.

Permissions required: Administer Jira global permission.

PUT /rest/api/3/screenscheme/{screenSchemeId}

FlagTypeRequiredDescription
--bodystringNorequest body (JSON string, @file, or - for stdin)
--screenSchemeIdstringYesThe ID of the screen scheme.

Example:

bash
jr screenscheme update-screen-scheme --screenSchemeId <screenSchemeId>