Create screen tab

POST

/rest/api/3/screens/{screenId}/tabs

Creates a tab for a screen.

Permissions required: Administer Jira global permission.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/screens//tabs' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Fields Tab"
}'

Response Example

200 - Success

{"id":10000,"name":"Fields Tab"}

Request

Path Params

screenId

integer

required

The ID of the screen.

Body Params application/json

A screen tab.

name

string

required

The name of the screen tab. The maximum length is 255 characters.

Examples

Responses

🟢200Returned if the request is successful.

application/json

Body

A screen tab.

integer <int64>

read-onlyoptional

The ID of the screen tab.

name

string

required

The name of the screen tab. The maximum length is 255 characters.

🟠400Returned if the request is invalid.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠403Returned if the user does not have the necessary permission.

🟠404Returned if the screen is not found.

Modified at 2023-07-13 03:27:27

Get all screen tabs

Update screen tab